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CONVERSION  FACTORS,  NON-ST  TO  SI  (METRIC) 
UNITS  OF  MEASUREMENT 


Non-SI  units  jf  .seas  v  recent  used  in  this  report  can  be  cor  erted  to  SI 


(metric)  units  as  follows. 

Multiply 

By 

To  Obtain 
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SMALL-BOAT  SURVEY  SYSTEMS 


PART  It  INTRODUCTION 


Background 


1.  Hydrographic  surveys*  are  a  '.'ital  part  of  the  US  Army  Corps  nf  Engi¬ 
neers  work,  effort  in  maintaining  and  improving  this  Nation's  waterways.  Sur¬ 
vey  information  is  needed  for  dredge  operations  and  payment,  new  project 
design,  reservoir  monitoring,  and  many  other  purposes.  In  all  cases,  the  sur¬ 
vey  information  must  go  through  a  sequence  of  steps  from  data  collection  to  a 
final  form  that  is  typically  a  chart  of  the  waterway,  showing  the  depths  as  a 
function  of  longitudinal  positions  on  the  chart.  Handling  and  processing  the 
large  volume  of  information  collected  during  hydrographic  surveys  is  a  very 
time-consuming  job,  if  performed  manually.  This  was  the  standard  procedure 
prior  to  1969.  In  that  year,  the  Headquarters,  US  Army  Corps  of  Engineers 
(HQUSACE)  directed  the  US  Army  Engineer  Waterways  Experiment  Station  (WES)  to 
pursue  research  aimed  at  automating  the  hydrographic  survey  work  of  the  Corps. 
Part  of  the  WES  research  effort  was  to  improve  communications  between  Dis¬ 
tricts  already  using  electronic  surveying  tools  and  those  using  only  manual 
methods.  Another  pate  of  the  WES  effort  was  to  improve  communication  between 
survey  equipment  suppliers  and  District  survey  personnel.  The  electronic 
positioning  and  data  processing  equipment  available  in  1970  was  more  efficient 
than  existing  manual  methods.  The  equipment  was  successfully  applied  by  many 
Corps  Districts  with  considerable  savings  in  costs  and  time.  A  significant 
limitation,  however,  was  flexibility  as  the  electronic  equipment  available  in 
1970  was  large  and  heavy,  and  consumed  considerable  electrical  power.  This 
limitation  restricted  the  use  of  electronic  surveying  equipment  to  relatively 
large  survey  boats. 

2.  Corps  Districts  must  survey  in  a  wide  variety  of  waterways,  and  many 
of  these  are  impractical  to  survey  using  large  survey  boats.  Some  isolated 
waterways  must  be  reached  overland  by  trailered  survey  boats.  Trailering  puts 
an  upper  limit  of  approximately  27  ft**  on  survey  boat  size,  and  even  this 


*  Unusual  cerms  are  defined  In  the  Glossary  (Appendix  E) . 

**  A  table  of  factors  for  converting  non-SI  units  of  measurement  to  SI 
(metric)  units  is  found  on  page  3. 


size  is  difficult  to  handle.  A  considerably  smaller  boat  is  more  easily 
transported.  Another  reason  that  small  survey  boats  are  necessary  is  that 
they  are  needed  to  work  in  small  channels  where  larger  boats  cannot  maneuver 
and  where  the  water  is  too  shallow  for  deeper  draft  boats.  This  need  to  use 
small  survey  boats  conflicted  with  the  need  to  automate  the  Corps  survey  pro¬ 
cess  due  to  the  size  of  the  existing  (1970)  commercial  electronic  surveying 
equipment . 

3.  In  response  to  Corps  District  requests  for  small-boat  electronic 
survey  equipment,  WES  initiated  two  different  equipment  development  projects. 
These  were  for  data  loggers  that  recorded  survey  data  on  magnetic  tape  cas¬ 
settes  and  permitted  the  data  to  be  processed  by  the  District  automatic  data 
processing  center.  Results  of  District  use  with  these  small-boat  survey  data 
loggers  are  given  for  the  fird  project  by  LaFountain  (1976)  and  for  the 
second  project  by  Thrower  (1973). 

4.  Use  of  survey  data  loggers  produced  a  significant  savings  in  data 
processing  time  in  the  Districts,  but  they  did  not  provide  pilot  guidance,  a 
capability  available  on  the  larger  survey  boats  that  had  a  minicomputer 
aboard.  There  also  remained  a  costly  lag  in  time  between  data  collection  and 
the  finished  chart. 

5.  Use  of  data  communication  links  to  transfer  data  from  a  survey  skiff 
to  a  larger  survey  boat  was  reported  (Boone  1980).  This  paper  gave  an  excel¬ 
lent  description  of  some  of  the  possibilities  related  to  separating  the  data 
collection  units  and  the  data  processing  units  of  a  system,  but  did  not  dis¬ 
cuss  communication  links  to  maintain  real-time  processing  speed. 

6.  By  1983,  the  availability  of  smaller  and  more  rugged  computers 
changed  the  picture  of  what  possibilities  were  available  for  developing 
small-boat  survey  systems  with  capabilities  almost  equal  to  those  possible  on 
a  large  survey  boat.  From  discussions  with  District  personnel,  it  became 
clear  that  the  need  for  an  improved  small-boat  surveying  system  was  important 
to  many  Districts.  With  HQUSACE  backing,  WES  proposed  that  a  special  Corps 
meeting  be  held  to  discuss  small-boat  survey  system  development.  This  meeting 
was  held  aL  the  Norfolk  District  in  December  1983.  Representatives  from  11 
Districts  attended,  which  was  a  good  indication  of  Corps-wide  interest  in 
small-boat  survey  systems. 

7.  At  this  meeting,  WES  personnel  presented  means  by  which  they  felt  a 
practical  small-boat  survey  system  could  be  developed.  The  WES  appraisal  of 
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commercially  available  components  indicated  the  following: 

a.  A  recently  available  portable  computer  by  Grid  Systems  Corpora¬ 
tion  should  be  capable  of  performing  on-line  in  real-time  the 
calculations  necessary  for  pilot  guidance,  data  recording,  and 
data  processing. 

b.  The  Grid  Systems  computer  could  be  programmed  in  a  high-level 
language,  FORTRAN,  so  that  the  survey  programs,  when  developed, 
could  be  modified  by  Corps  personnel  as  needed. 

c.  By  using  modern  communication  technology  the  electronic  compo¬ 
nents  of  a  survey  system  could  be  split  into  groups  for  optimum 
use  of  available  boat  and  land  vehicle  space.  For  very  small 
boats  the  system  could  be  configured  so  that  only  a  depth 
sounder  and  pilot  guidance  indicator  need  be  aboard  the  boat  and 
the  remainder  of  the  electronic  equipment  would  be  in  a  van  or 
truck  on  the  shore  (Figure  1).  For  larger,  but  still  trailer- 
able,  boats,  the  system  could  be  configured  so  that  most  of  the 
equipment  would  be  on  the  boat  and  the  amount  of  equipment  on 
the  shore  would  be  minimized  (Figure  2).  In  either  case,  the 
size,  weight,  and  power  consumption  of  the  components  would  be 
kept  to  the  smallest  available  at  the  time. 

8.  District  response  at  the  1983  meeting  at  Norfolk  unanimously  con¬ 
firmed  the  need  for  a  small-boat  survey  system.  Response  from  the  Districts 
as  to  the  best  configuration  to  use  was  not  clear,  for  the  concepts  presented 
were  new  and  needed  time  to  be  understood.  There  was  no  question  about  Dis¬ 
trict  need  for  a  small -boat  survey  system  and  the  KQUSACE  representative 


Figure  1.  Proposed  hardware  configuration 


Figure  2.  Computer  hardware  with  pilot  indicator 


directed  WFS  to  give  a  high  priority  to  the  development  of  a  small-boat  survey 
system. 

Purpose 

9.  The  purpose  of  this  study  was  to  develop  the  software  and  hardware 
components  J..^t  could  be  combined  into  a  system  that  would  satisfy  the  re¬ 
quirements  for  performing  Corps  hydrographic  surveys  using  a  small  boat  as  the 
survey  vehicle.  It  was  recognized  that  software  development  would  be  the  pri¬ 
mary  Corps  effort  and  that  the  system  haraware  wo^ld  be  assembled  com¬ 

mercially  available  components. 

Scope 

10.  This  report  describes  the  hardware  and  software  developed  by  WES  for 
small-boat  surveys.  Example  systems  in  use  by  Corps  Districts  are  discussed 
to  assist  the  reader  in  determining  which  comoination  of  components  would  be 
most  suitable.  Each  developed  software  package  is  discussed  in  detail.  In 
addition,  software  packages  developed  to  meet  specific  District  needs  are 
d  iscussed . 
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.  ,kT  II;  DEVELOPMENT  AND  PROCUREMENT  OF  SYSTEM 


11.  At  the  meeting  of  December  1983  at  the  Norfolk  District,  the  basic 
system  hardware  configuration  was  proposed  and  adopted.  The  hardware  con¬ 
sisted  of  a  Grid  Systems  computer  for  processing,  a  theodolite-type  range- 
azimuth  positioning  system,  a  radio-linked  depth  system,  a  printer,  a  small 
plotter,  a  pilot  guidance  display,  a  disk  drive,  and  a  ruggedized  bubble 
cartridge  drive  (Figure  1).  The  development  was  approved  by  those  in  atten¬ 
dance  with  a  decision  to  proceed  with  procuring  hardware. 

Computer 


12.  The  Grid  Systems  Compass*  computer  (Figure  2)  was  selected  based  on 
ruggedness  and  ability  to  perform  real-time,  multitasking,  closed-loop  process 
control.  Since  the  system  was  considered  Automatic  Data  Processing  (ADP) ,  the 
requisition  and  supporting  ADP  documents  were  submitted  for  ADP  approval  in 
January  1984.  ADP  approval  was  received  and  the  rewritten  requisition  was 
submitted  to  the  WES  Contracting  Division  in  August  1984;  the  system  was  re¬ 
ceived  and  a  1-week  vendor  course  on  the  system  was  attended  in  November.  The 
system  was  demonstrated  numerous  times  including  the  Corps  Surveying  Confer¬ 
ence  at  Jacksonville,  FL,  February  1985,  and  Savannah,  GA,  February  1988 
(McCleave  1985,  1988). 


Positioning  System 

13.  A  competitive  procurement  action  for  the  range-azimuth  positioning 
system  (Appendix  A  discusses  the  positioning  systems)  was  begun  with  the  sub¬ 
mission  of  a  requisition  in  May  1984.  The  positioning  system  was  delivered  in 
December  1985.  There  were  some  major  problems  with  starting  up  the  position¬ 
ing  system  ('it  required  a  particular  string  of  characters  from  the  computer) 
that  were  not  resolved  until  a  few  days  before  its  debut  at  the  Corps  Survey¬ 
ing  Conference  in  .Jacksonville,  FL ,  February  1985  (McCleave  1985).  The  posi¬ 
tioning  system  was  found  to  have  three  major  shortcomings  for  hydrographic 


*  At  the  time  testing  was  conducted.  Compass  was  a  registered  trademark  of 
(aid  .Systems  Corporation. 
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work:  (a)  it  had  a  hardware  range  break  at  1  km,  (b)  the  precise  time  at 

which  the  range  measurement  was  taken  was  not  actually  known,  and  (c)  it  was 
impossible  for  an  operator  to  follow  a  moving  boat  and  keep  it  "locked  on”  for 
more  than  a  few  seconds  at  a  time. 

14.  The  vendor  chose  not  to  address  these  problems,  so  WES  devised  a 
scheme  to  add  a  joystick  servo-drive  control  to  the  device  to  aid  an  operator 
in  smoothly  following  a  moving  target.  This  modification  was  awarded  on  a 
low-bid  basis  in  July  1986.  Even  with  the  joystick,  it  was  hard  for  an  opera¬ 
tor  to  stay  locked  on  a  moving  boat  for  more  than  30  sec  at  a  time  because  the 
positioning  system  was  too  sensitive  (having  to  be  exactly  on  the  prism  con- 
tinously).  Therefore,  the  range-azimuth  system  procured  was  determined  to  be 

unacceptable.  At  this  time  a  search  of  available  alternative  range-azimuth 
theodolite-type  systems  was  made. 

15.  Another  vendor,  International  Measurement  and  Control  (IMC),  became 
very  interested  in  the  WES  development  effort  in  September  1987.  The  vendor 
loaned  WES  a  Hydro  1*  unit  (Figure  3)  for  several  weeks  for  testing.  The  unit 
was  found  to  work  well  in  all  respects  but  two:  (a)  vertical  tracking  was 
awkward,  and  (b)  the  length  of  time  of  the  range  measurement  was  known  only  to 
within  0.8  sec.  The  vendor  voluntarily  corrected  both  problems  by  (a)  adding 
a  vertical  movement  lever  that  worked  well  with  the  horizontal  crank,  and 

(b)  rewriting  the  internal  firmware  to  allow  input  of  a  synchronizing  charac¬ 
ter  from  the  computer  and  returning  a  data  age  time  allowing  the  sample  time 
to  be  known  within  0.1  sec.  The  vendor  loaned  WES  a  revised  unit  to  demon¬ 
strate  the  sm.',  11-boat  system  at  the  Corps  Surveying  Conference  in  Savannah, 

GA,  in  February  1988  (McCleave  1988)  .  An  operator  could  easily  follow  a  boat 
with  the  unit,  and  no  shortcomings  were  noted. 

Depth  System 

16.  There  was  no  known  commercially  available  depth  system  that  would 
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four  problems,  the  worst  of  which  was  that  the  IEEE488  interface  was  inopera¬ 
tive.  The  IEEE488  interface  was  to  be  the  communication  link  between  the 
depth  sounder  and  the  computer;  without  it,  verification  of  the  depth  sounder 
coull  net  proceed.  After  numerous  attempts  to  find  the  solution  to  the  prob¬ 
lem,  including  a  3-day  trip  to  the  factory,  it  appeared  the  vendor  was  going 
to  be  unable  co  resolve  the  problem.  After  waiting  tc  be  sure  the  vendor  was 
not  going  to  respond  in  a  positive  manner,  a  new  competitive  procurement  was 
begun. 

17.  A  contract  to  design  a  radio-linked,  IEEE488-interfaced  depth 
sounder  was  awarded  to  Innerspace  Technology  Corporation  in  July  1986.  A  com 
pleted  unit  was  delivered  in  October  of  1986  (Figure  4) .  The  unit  was  field 
tested  and  no  deficiencies  were  noted.  The  unit  was  demonstrated  at  the 
February  1988  Savannah  conference  (McCleave  1988) ;  the  vendor  also  had  a  unit 
at  its  conference  booth,  as  the  system  was  being  marketed  as  a  commercially 
available  standard  product. 
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Figure  4.  Innerspace  Technology  depth  sounder  system 


Pilot  Guidance  Meter 

18.  In  talking  with  Districts,  it  was  determined  that  an  analog  style 
left/right  pilot  guidance  indicator  was  the  easiest  to  steer  by.  Since  vari¬ 
able  meter  scale  and  distance  along  the  line  were  also  desirable,  it  was 
decided  to  procure  a  digital  graphical  display  which  could  emulate  an  analog 
meter.  This  would  require  either  an  intelligent  display  or  a  display  with  a 
high-speed  interface  so  that  the  computer  could  provide  the  graphics.  Since 
one  configuration  would  place  the  computer  on  shore  and  the  display  on  the 
boat,  an  intelligent  display  with  a  modem  interface  was  decided  upon.  Radio 
Shack*  was  known  to  market  an  economical,  small,  lightweight  computer  which 
met  these  criteria  (Figure  5).  Therefore,  a  lequisition  was  issued  in 
September  1984,  and  the  unit  was  received  a  few  weeks  later.  The  coding  was 
done  by  WES;  the  only  problem  noted  was  that  the  unit  could  operate  only  a  few 


*  Radio  Shack  is  a  registered  trademark  of  the  Tandy  Corporation. 
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Figure  5.  Radio  Shack  pilot  guidance  computer 

hours  on  internal  batteries  and  required  the  external,  battery-eliminator 
module.  No  problems  were  noted  with  the  module.  The  unit  was  demonstrated  at 
both  the  1985  Jacksonville  and  the  1988  Savannah  conferences  (McCleave  1985 
and  1988,  respectively). 

Ruggedized  Storage 

19.  The  computer  procured  was  capable  of  taking  130  g's  of  vibration, 
but  the  disk  drive  was  rated  only  at  3  g's;  therefore,  a  more  ruggedized  stor¬ 
age  media  was  desired  for  rough  conditions.  Any  storage  media  which  uses  mov¬ 
ing  parts  cannot  sustain  high  shock  levels;  therefore,  a  removable  cartridge 
bubble  drive  was  procured.  The  requisition  was  issued  to  Targa  Electronics  in 
September  1984,  and  the  drive  was  delivered  in  February  1985  (Figure  6).  A 
vendor  recall  was  issued  and  the  unit  was  returned  to  the  factory  in  March 
1985  to  correct  a  write-protect  logic  problem.  As  delivered,  the  unit  was 
good  only  for  data  storage  (using  specialized  software)  and  could  not  be  used 
as  a  standard  peripheral  (with  vendor  programs).  However,  the  vendor  later 
developed  hr  id  disk  drive  emulation  firmware  (which  was  installed  at  no  cost 
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Figure  6.  Computer  system  with  Targa  bubble  memory  unit,  plotter,  and 

printer 


in  October  1985)  for  the  IEEE488  interface.  This  allowed  the  bubble  drive  to 
function  as  a  standard  storage  device  appearing  to  the  computer  as  an  external 
floppy  (or  hard)  disk.  The  unit  was  loaned  to  the  Louisville  District  in  1986 
for  field  evaluation  and  found  to  be  intermittent  and  unusable.  The  unit  was 
returned  to  the  factory  and  a  revision  to  the  write-protect  logic  was  made. 
Since  then,  no  problems  have  been  noted;  however,  it  has  not  been  extensively 
tested.  The  unit  was  demonstrated  at  both  the  1985  Jacksonville  and  the  1988 
Savannah  conferences  (McCleave  1985  and  1988,  respectively). 

Plotter 


20.  A  small  plotter  (8.5-  by  11-in.  paper)  was  procured  with  the  com¬ 
puter  system  (Figure  6).  However,  it  soon  became  apparent  that  developing  a 
plan  view  program  would  require  the  ability  to  plot  on  larger  paper.  Between 
17  January  1986  and  17  February  1986,  a  plotter  was  rented  to  aid  in  software 
development.  However,  there  was  a  recurring  need  to  add  large  plot  enhance¬ 
ments  to  be  able  to  demonstrate  plotting  and  to  help  Districts  trouble-shoot 
problems.  Therefore,  a  low-cost  D-size  (22-  by  34-in.)  Hewlett-Packard  Draft- 
pro*  plotter  was  requisitioned  in  August  1987  and  delivered  in  September  1987 

*  Hewlett-Packard  and  Draftpro  are  registered  trademarks  of  Hewlett-Packard 
Company . 
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(Figure  7).  This  plotter  ran  all  existing  software  without  modification  and 
no  problems  have  been  noticed.  It  was  demonstrated  at  the  Savannah  conference 
in  February  1988  (McCleave  1988). 


Printer 


21.  A  small  printer  from  Hewlett-Packard  was  requisitioned  in  August 
1984  and  delivered  a  month  later  (Figure  6).  No  problems  have  been  noted  with 
the  printer.  It  was  demonstrated  at  both  the  1985  Jacksonville  and  the  1988 
Savannah  conferences  (McCleave  1985  and  1988). 

Radio  Link 

22.  The  additional  radio  link  necessary  for  connecting  the  land-based 
computer  with  the  ship-based  pilot  guidance  display  was  originally  ordered  in 
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February  1985.  The  first  supplier  was  unable  to  deliver  the  radio  link  as 
specified;  and  a  new  requisition  was  issued  to  Motorola,  and  the  unit  was 
delivered  in  August  1986  (Figure  8).  The  radio  link  was  field  tested  on  sev¬ 
eral  occasions.  In  March  1987  during  a  demonstration  of  the  system  to  HQUSACE 
and  field  personnel  in  Fort  Belvoir,  VA,  an  output  transistor  went  out,  ren¬ 
dering  the  unit  nonoperational .  However,  since  then  no  problems  have  been 
noted.  The  link  was  demonstrated  at  the  1988  Savannah  conference  (McCleave 
1988)  . 


Figure  8.  Motorola  pilot  guidance  radio  link 
Software 


23.  Software  is  discussed  in  Part  III. 

Conf igurations 

24.  The  system  was  designed  to  function  in  either  of  two  hardware 
configurations:  (a)  configuration  1,  computer  on  shore  (Figure  9)  or  (b)  con¬ 
figuration  2,  computer  on  boat  (Figure  10).  Both  configurations  can  use  the 
same  hardware  with  the  only  difference  being  method  of  connection.  In  the 
first  configuration,  radio  links  replace  wires  for  communication  of  depth  from 
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Figure  10.  Configuration  2,  computer  on  boat 
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boat  to  shore  and  pilot  guidance  from  shore  to  boat.  In  the  second  configura¬ 
tion,  a  radio  link  replaces  wires  for  communication  of  position  from  shore  to 
boat.  The  same  software  works  with  either  configuration,  as  the  connecting 
links  aiE  transparent  to  the  computer.  The  configuration  diagrams  are  drawn 
for  range-azimuth  equipment.  Range-range  equipment  normally  places  the  com¬ 
puter  on  the  boat  as  in  the  second  configuration.  Global  satellite  position¬ 
ing  systems  would  rcrm?.]  ly  be  similar  to  configuration  7  Any  additional 
inputs,  such  as  tide  gages,  would  connect  to  the  computer  by  IEEE488  with 
radio  links  used  as  needed. 

25.  The  only  District-tested  systems  have  been  using  configuration  2, 
with  the  computer  on  the  boat  and  using  an  Innerspace  digitizer.  The 
presently  used  field  systems  are  shown  as  follows: 


District 

Field  System 

Registered 
Trademark  of 

Figure 

Mobile 

Del  Norte 

Del  Norte  Technology 

11 

Autotape 

Cubic  Precision  Corp . 

12 

Panama  City 

Mini-Ranger  III 

Motorola,  Inc. 

13 

Polarf ix 

Krupp  Atlas 

14 

Louisville 

Del  Norte 

Del  Norte  Technology 

15 

Huntington 

Del  Norte 

Del  Norte  Technology 

16 

The  WES-demonstrated 

system  of  the  first  configuration  (Figure 

17)  used  an  IMC 

range-azimuth  system 

and  could  function 

in  either  configuration 

.  The  minimum 

hardware  required  is  listed  in  Table  1  .  Special  cabling  is  diagrammed  in 
Appendix  B. 


Capabilities 

26.  A  small-boat  system  capable  of  performing  dredging  payment,  recon¬ 
naissance,  and  buoy  placement  surveys  was  developed  (Figure  18  shows  a  typical 

small  boat  and  equipment).  Ocean  surveys  and  sweep  system  surveys  were  out¬ 
side  the  scope  of  this  development  effort  (however,  the  basic  system  could  be 
modified  to  address  these  and  other  needs). 

27.  The  hardware  and  software  are  modular  so  that  positioning  and  depth 
equipment  can  be  easily  exchanged  in  the  field  (if  software  modules  have  been 
written  for  the  particular  hardware).  To  provide  this  capability,  range  and 
depth  information  come  directly  into  the  computer,  not  through  some  vendor  box 
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Figure  11.  Mobile  Del  Norte 


NOTE  Prices  listed  *ere  those  at 
time  Mobile  System  uas  procured 


CUBIC  WJTOTAPE 
DM43 
«i25. eee 
34  L8S 

100  I-WTT5 ,  12  u 


HuMCiA  EM  c>00 
GENERATOR 

t  7  M* 

42  i  B  . 

4W  WATTS  t'HTEO 


COTBC  MP^O  «. 
FLOPPY  01SK 
GPiD  2101 
*3250 
18  LBS 

20  WATTS .  110  U 


/ 

/ 

/ 

/ 

PLOTTER  HP 7586 

PRINTER  t^223A 

*16.900 

*400 

190  LBS 

7  5  LBS 

182  WATTS.  1 10  U 

17  WATTS,  110U 

Figure  12.  Mobile  Cubic  Autotape 
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NOTE  Prices  1  i st*<j  w«r«  those  at 
t in«  Panama  City  System  was  proofed 


12  0  TO 

110  U 

INUERTER 

PU400 

*163 

110  U 


►ff>  DRAFTPRO 
PLOTTER  7570 
*4,  104 
66  UBS 


TPS  NOOEL  100 
EXE  CUT  I UE  WORKSLATE 
PILOT  CUrOAMCE 
*399  490  LBS 

INTERNAL  BATTERY 
OR  110  U 


or 

Mltl  UJ1 
cwrtru 

11  Us 
79  NI1S.  119  • 


COMBO  HARO  t 
FLOPPY  DISK 

GRiO  2101 
*3198 
18  L0S 

28  WATTS,  110 


PRINTER  HP223A 
*400 
7.3  LBS 

17  WATTS,  1100 


Figure  13.  Panama  City  Mini-Ranger  III 


NOTE  Prices  listed  were  those  at 
time  Panama  City  System  was  procured 


INNERSTACE 
TECHNOLOGY 
MODEL  488 
SOUND 1 1C 
MACHJKt 
*13,422 
12  UOLTS 


}  110  U 


PLOTTER  HP 75868 
*12.844 
190  LBS 

1 82  WATTS ,  1 1 0  U 


TRS  MODEL  100 

EXE  CUT  IUE  WORKSLATE 

\ 

PILOT  GUIDANCE 

f 

*399  4  LBS 

INTERNAL  BATTERY 

OR  110  0 

I  5fn  ruFTr 
MOCl  UM 
toiffim* 
*«X  11  Ibj 

71  WITS.  110  Q 


FLOPPY  OISK 
GRID  2101 
*3198 
18  LBS 

20  WATTS,  110  0 


KRUPP  ATLAS  ^ 

I  N 

KRUPP  ATLAS 

POLARFIX 

0  K 

polarfix 

TELEFACE  A2 

- > 

telemetry 

1926 

TRANSMITTER 

42  WATTS 

42  WATTS 

24  UOLTS 

12  UOLTS 

KPUPP  ATLhS  POLARFIX 
SYSTEM  *113.000 


PRINTER  HP225A  | 
t40C 
7  5  LBS 

17  WATTS.  1 10U j 


ligure  14.  Panama  City  Krupp  Atlas  Polarfix 
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MOTE  Prices  listed  were  those  at 
tin*  Louisville  System  was  procured 


DEL  NORTE  520 
*10,472 
29  LBS 

40  WATTS,  24  0 


12 

UOLT 

BOAT 

BATTERY 

1 

12  U 

71?  B 

Raytheon 

41 

lbs 

12 

UOL  TS 

INNEPSPACE 
445  DIGITIZER 

*7260 
8  5  LBS 

30  whits,  12  u 


24  UOLT  POWER 
SUPPLY 
90  WATTS 
*145 
3  LBS 
110  OOLTS 


HONDA  EM  see 
GENERATOR 
•  390 
42  LBS 

450  WATTS  RATED 


COMBO  HARO  i 
FLOPPY  DISK 
GRID  2101 
*3250 
18  LBS 

28  WATTS,  110  U 


kr 

bRli 

fT  ItKl  1125 

TPS  MOOEL  102 

\  CBNPUlCIt 

EXECUTIL€ 

\  \  W9$  11  lbs 

WORT SLATE 

\  \  u  i sms.  in  n 

PILOT  GUIOAMCE 

\ 

*490  4  LBS 

\ 

INTERNAL  BATTERY 

\ 

OP  110  'J 

^  WiO 

\ 

PLOTTER  1*>?475 
*1900 
16  LBS 

35  MATTS,  110  U 


1 

S' 

iti 

'  • 

PRINTER  HP 225A 
*400 

7  5  LBS 

17  MATTS,  110U 

HARP  I S  500 
IN  HOUSE 
COMPUTER 


Figure  15.  Louisville  Del  Norte 


NOTE  Prices  listed  were  those  at 
tine  Huntington  System  was  procured 


DEL  NORTE  542 
*15,775 
34  LBS 

46  WATTS,  24  U 


♦ 

ri 

1  2 

BOAT  I 

j  BhTTEPIES  1 

24  " 

jr 

2  U 

719  8 

PAY  T  HEW 

47 

LBS 

12 

UOLTS 

INNER SPACE 

445 

0IGITI2EP 

*7260 

8  5  LBS 

30 

WAT  TS  ,  12  U 

_ 1 

hOCA  EM  600 
GENERATOR 
*390 
42  LBS 

450  WATTS  RATED 


coreo  hard  t 

FLOPPY  OISV 

GRID  2101 
*3250 
18  LBS 

28  WATTS,  110  V 


• — 

OK!"  ~zimr> 
nm  iui 

COWMIR 

WW  1*  lbs 

TPS  MOOEL  102 
EXECUTIUE 

UORf  SLATE 

v 

«  Mils.  110  tt 

PILOT  GUIDANCE 

\ 

X 

*400  4  LBS 

INTERNAL  BATTERY 

MUD 

\ 

OP  110  U 

PLOTTER  WV475 
*1900 
16  LBS 

35  MATTS,  110  U 


PRINTER  HP 225A 
*400 
7.5  LBS 

17  MATTS.  110U 


HARRIS  508 
IN  HOUSE 
COMPUTER 


Figure  16.  Huntington  Del  Norte 


21 


Figure  17.  WES  IMG 


Figure  18.  Panama  City  Area  Office  boat  and  equipment 
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that  ties  them  together  through  a  common  interface.  This  requires  that  the 
positioning  system  have  an  RS232  (Electronic  Industries  Association  1969) 
interface  and  that  the  depth  measuring  system  have  an  IEEE488  interface. 

28.  Four  survey  styles  are  allowed:  (a)  section  line,  (b)  Louisville, 

(c)  random,  and  (d)  find  spot  (Figure  19).  The  survey  styles  are  modular  and 
new  styles  could  be  added  basically  by  changing  the  operator  interface 
software  module.  The  survey  styles  are  discussed  in  detail  in  Part  III  and 
Appendix  C. 

0 


SECTION  LIME 

0 

LOU I SU I LLE 


/ 

E I  HD  SPOT 


Figure  19.  Survey  styles 

29.  Plotting  is  supported  both  on-line  and  afterwards.  On-line,  the 
current  boat  position  is  shown  by  pen  position  at  all  times;  depths  are  plot¬ 
ted  when  data  saving  is  enabled.  Afterwards  three  plot  types  may  be  produced 
f  a)  plan  view  with  features,  labeling,  and  contours  (Figure  20),  (b)  cross 
sections  (Figure  21),  and  (c)  three  dimensionally  stacked  cross  sections  (Fig 
ure  22;.  The  plot  types  are  discussed  in  detail  in  Part  III  and  Appendix  (. 

50.  Printing  is  supported  on-line  and  afterwards.  On-line  easting, 
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8 


-  -  8  3  5  5  3-  *  5  * 

3  3  3S8SS85  3  - 

Figure  20.  PLAN_VIEW_PLOTTER 

northing,  and  depth  may  be  printed  at  a  predetermined  interval.  Afterwards, 
data  and  dredging  quantities  may  be  printed. 

31.  Since  the  survey  program  is  written  as  3  group  of  tasks  (modules) 
which  are  basicallv  independent,  most  hardware  operations  can  take  place  at 
speeds  close  to  the  maximum  possible.  For  example,  since  depth  acquisition  is 
in  a  separate  module  from  position,  depths  may  be  acquired  ten  times  per  sec¬ 
ond  while  position  is  acquired  only  ones  per  second.  The  data  are  recorded 
independently  and  time  marked  by  a  common  clock  in  the  computer.  Position  is 
then  determined  by  piecewise  linear  interpolation  at  the  times  the  depths  were 
acquired  (by  postprocessing  programs).  The  net  effect  is  that  position  versus 
depth  is  available  at  10  times  per  second  for  cross-section  plots  and  dredging 
computations.  While  this  "high-speed"  computation  is  taking  place,  the  opera¬ 
tor  may  leisurely  change  the  display  scale,  record  tides,  mark  spots,  etc.,  in 
the  background  (l.e.,  at  a  low  priority). 

32.  The  pilot  (helmsman)  has  independent  control  of  his  display  as 
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Figure  22.  3D  PLOT 


graphics  are  generated  and  controlled  within  the  pilot  indicator  computer 
(distributed  processing).  Update  information  is  sent  to  his  display  about 
once  every  O.H  sec,  as  it  becomes  available.  Function  keys  are  used  for  in¬ 
puts  of  scale  change  and  display  form  (auto  scaling  may  be  enabled  if 
desired) . 


Evaluation 


33.  The  software  has  been  extensively  field  evaluated  by  several  Dis¬ 
tricts,  primarily  Mobile.  Problems  were  corrected  as  thev  were  discovered  and 
enhancements  have  been  made.  Since  hydrographic  surveying  is  an  evolving 
field,  no  software  or  hardware  can  ever  be  considered  complete.  However,  all 
codes  and  information  generated  are  available  to  Districts  (i.e.,  there  is 
nothing  proprietary  in  the  package)  and  consultation  by  WES  personnel  is 
available  on  a  cost  per  time  basis  if  needed.  In  general,  the  system  has  been 
proven  to  be  easy  to  use  by  surveyors  (i.e.,  computer  types  are  not  required), 
but  onsite  training  is  recommended. 

34.  The  Districts,  thus  far,  have  all  opted  for  the  computer-on-boat 
hardware  configuration,  and  this  configuration  has  been  thoroughly  tested. 

The  equipment-on-shore  method  has  not  been  tested  as  extensively.  The  only 
real  difference  between  the  two  is  radio  links;  therefore,  the  main  concern 
which  has  not  been  addressed  is  how  susceptible  will  the  system  be  to  local 
radio  interference.  However,  dedicated-band,  Government-only  frequencies  were 
selected;  so  this  should  not  be  a  problem. 
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35.  Some  experimentation  was  done  with  prism  arrays  for  targeting. 
One-inch  and  two-and-one-half-inch  prisms  were  tested.  The  smaller  prisms  may 
be  more  tightly  spaced  but  form  a  weaker  target.  The  best  configuration  found 
was  the  one  commonly  provided  by  vendors:  two  rows  of  six  prisms  each  in  a 
circular  pattern  around  a  pole.  The  prism  rows  are  offset  30  deg  such  that  a 
prism  occurs  at  each  30-deg  interval  around  the  pole.  Reflectors  around  the 
prisms  (provided  by  some  vendors)  are  desirable.  In  addition  to  the  prisms,  a 
vertical  foot  of  reflective  tape  is  wrapped  around  the  pole  immediately  below 
the  prises.  The  tape  provides  a  "close  in"  target  and  the  prisms  provide  a 
long-range  target.  This  enables  smooth  operation  from  100  ft  to  2  miles 
separation  between  the  theodolite  and  the  boat. 
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PART  III:  SOFTWARE 


36.  A  number  of  surveying  programs  have  been  developed.  These  include 
presurvey,  survey,  and  postsurvey  programs.  The  package,  as  it  is  now  imple¬ 
mented,  is  designed  to  do  zigzag  surveys,  random  surveys,  and  find  spot  sur¬ 
veys.  Cross-section  surveys  are  extensively  supported.  Profile  and  random 
lines  can  presently  be  run  and  plotted  in  plan  view  (Figure  23).  A  program  to 
fit  data  from  profile  and  random  surveys  to  section  lines  generated  afterwards 
is  planned  but  is  not  part  of  this  development.  Profile  surveys  are  best  run 
with  sweep  systems.  This  package  does  not  presently  support  sweep  systems. 

37.  Part  III  provides  an  overview  of  most  programs  in  the  package.  A 
detail  of  each  program  is  included  in  Appendix  C.  The  information  layout  in 
memory  and  in  disk  files  is  given  in  Appendix  D. 

PROF ILE 


Figure  23.  Survey  patterns 
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Design  Criteria 


38.  The  design  philosophy  has  been  to  acquire  as  much  data  as  possible, 
as  accurately  as  possible,  while  providing  a  user-friendly  operator  interface 
and  frequent  pilot  guidance  updates.  These  goals  have  largely  been  met. 

39.  To  provide  a  user-friendly  operator  environment,  the  Grid  Systems 
menu/form  package  has  been  incorporated  in  most  of  the  programs.  A  form  (for 
input  of  multiple  items)  is  displayed  on  the  screen  with  default  or  previous 
values  shown.  The  operator  then  uses  the  cursor  to  move  about  and  change 
selected  items  by  either  selecting  from  a  list  of  choices  at  the  desired  form 
position  or  typing  in  a  value  for  a  particular  item.  When  he  is  satisfied 
with  the  form's  contents,  he  confirms  it  and  the  program  continues. 

4C.  To  collect  data  at  the  highest  possible  rate  and  provide  the  pilot 
with  rapid  updates,  modular,  concurrent  tasks  were  used.  The  survey  multipro¬ 
gram  is  composed  of  a  set  of  independent  tasks  that  interact  with  each  other 
using  a  common  block  of  memory  through  which  data  and  semaphores  are  passed. 
One  task  is  dedicated  to  acquiring  position  information  and  computing  boat 
position,  both  absolute  and  relative  to  the  desired  survey  line.  Another  task 
acquires  depth  information.  A  third  task  sends  pilot  guidance  information  to 
the  pilot  indicator.  A  fourth  prints  current  data.  A  fifth  plots  current 
data.  And  still  another  program  displays  graphically  the  boat's  position  and 
allows  operator  inputs.  Since  all  tasks  can  effectively  take  place  concur¬ 
rently  and  independently,  each  part  does  not  have  to  wait  for  the  others  to  be 
completed  before  it  can  start  the  next  cycle  (concurrent  processing).  Depths 
and  positions  can  be  saved  at  rates  up  to  10  times  per  second.  Also,  operator 
intervention  such  as  changing  display  scales  will  not  affect  the  data  acquisi¬ 
tion  and  pilot  indicator  update  rates.  To  synchronize  the  data,  an  internal 
clock  is  read  each  time  a  position  or  depth  is  acquired  and  the  time  is  saved 
along  with  the  acquired  data.  Analysis  programs  then  linearly  interpolate  the 
position  readings  to  get  positions  at  the  time  depths  were  acquired,  providing 
position/depth  information  at  0.1-sec  intervals.  Multitasking  like  this 
operation  on  the  Grid  computer  is  not  possible  on  MS-DOS*  computers.  This 
multitasking  capability  was  an  important  factor  in  selecting  the  Grid  computer 
for  the  small  boat  system. 


*  MS-DOS  is  a  registered  trademark  of  Microsoft,  Inc. 
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Figure  24.  Power-up  display 


41.  To  add  a  personal  touch  to  each  survey  vessel's  system,  a  picture 
of  a  surveying  boat  (or  a  picture  selected  by  the  survey  crew)  with  the 
particular  vessel’s  name  on  the  top  is  displayed  on  power-up  (Figure  24). 

High-Level  Software 

42.  To  allow  Districts  that  have  in-house  programmers  to  better  use  the 
system,  all  programs  are  written  in  FORTRAN,  and  a  plot  package  using  industry 
standard  plot  commands  (PLOT,  AXIS,  SYMBOL,  etc.)  is  provided.  Therefore, 
analysis  and  plot  programs  can  be  moved  to  the  Grid  computer  with  much  less 
effort  than  would  otherwise  be  required.  This  allows  District-written  soft¬ 
ware  to  be  run  in  the  field  without  need  of  transferring  data  to  the  main  Dis¬ 
trict  computer.  Data  may  be  transferred  via  phone  line  to  the  District's  main 
computer  if  desired. 

Survey  Types 

43.  The  package  presently  supports  four  kinds  of  surveys:  section 
lines,  Louisville  style,  random,  and  find  spot.  Typical  programs  used  in  the 
surveys  are  shown  in  Figures  25-27.  Section  line  surveys  involve  presurvey 
line  generation  and  postsurvey  processing  in  the  office.  This  approach  is 
used  by  offices  that  pay  dredgers  by  quantity  of  material  removed.  Louisville 
style  surveys  require  no  office  preparation  as  a  final  plot  is  produced  during 
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the  survey.  This  approach  is  used  by  offices  that  pay  dredgers  by  the  hour  as 
there  are  no  known  control  points.  Random  surveys  are  a  superset  of  section 
line  surveys  in  that  not  only  may  predefined  channel  and  section  line  coordi¬ 
nates  be  used,  but  also  lines  may  be  generated  from  current  boat  position  at 
the  site.  Random  surveys  are  good  for  general-purpose  use  as  they  allow  field 
determination  of  coordinates  referenced  from  known  control  points.  Find  spot 
allows  proceeding  to  a  number  of  predetermined  spots  for  buoy  placement  or  the 
like . 


Presurvey 


44.  There  are  two  presurvey  programs  in  the  package  for  section  line  or 
random  surveys.  One  accepts  site  information  from  the  keyboard  and  produces  a 
file  containing  lines  to  be  surveyed.  The  other  accepts  equipment  information 
from  the  keyboard.  Since  numerous  files  will  be  associated  with  each  survey 
site,  the  files  are  named  by  a  convention  that  uses  the  site  name  for  a  base 
and  the  type  of  information  in  the  file  for  an  extension.  The  operator  sup¬ 
plies  the  site  name  and  the  programs  supply  and  assume  the  extensions. 

45.  The  NEW_LINE_INPUT  is  a  form-driven  program  that  accepts  informa¬ 
tion  from  the  keyboard  for  a  new  site  or  from  a  previously  created  site  file. 
If  a  previously  created  file  is  to  be  modified,  the  operator  enters  the  site 
name  (such  as  ARLINGTON)  into  the  first  form  displayed  (Figure  28).  The  next 
form  has  five  items  of  text  and  one  menu  item  (Figure  29).  This  form  is  used 

iteiiiaswaiaiiM  no  input  fti  f 

INPUT  FILE  NAME  fSEEI'NCTQN  .  . j 


ENTER  INPUT  FILE  NAME  AND  CONFIRM 


Figure  28.  File  form:  NEW_LINE_INPUT 


TEXT  STRING 


LINE  1  ARLINGTON  UPPER  CHANNEL 

LINE  2  WIND  2  HANTS 

L  INE  7.  TEMPERATURE  75  DEGREES  FAHRENHEIT 

LINE  4  RU&rjEVOfi  1  (JILL  L.  IT5D0HE - 

L I NE  5 

MOPE  INFO'  NO 


ENTER  SITE  DESCRIPTION  BLOCK  1 


Figure  29.  Site  description:  NEW_LINE_INPUT 

to  enter  descriptive  text  about  the  site  or  survey  conditions.  The  next  sec¬ 
tion  of  the  program  allows  entering/modifying  (Figure  30)  channel  coordinate 
information  (Figures  31  and  32).  The  channel  coordinate  form  (Figure  33) 
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Figure  30.  Channel  modify  form:  NEW_LINE_INPUT 
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Figure  31.  Kethod  of  defining  channel 
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Figure  32.  Channel  sections  (Continued) 
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NEW_LINE_INPUT 

Channel  index  numbers  when  using  rectangular  or  nonrectangular  input  methods 
are  defined  by  relationship  to  the  channel  coordinate  pairs. 

Channel  Coordinates 

Assume  a  survey  with  channel  coordinate  pairs 


1. 

A(L),A(R) 

2. 

B(L),B(R) 

3. 

C (L) ,C(R) 

4. 

D(L) ,D(R) 

5. 

E(L) ,E(R) 

6. 

F(L),F(R) 

7. 

G(L),G(R) 

8. 

H(L) ,H(R) 

9. 

I  (L)  ,  I  (R) 

where  A(L)  is 

A(LE) , 

A(LN) 

A(R)  is 

ACRE), 

A(RN) 

Channel  indices  are  determined  by  an  area  of  channel  plan  view  with  index 
number  of  first  channel  coordinate  pair  used  and  are  shown  as  1-8. 
section  Lines 

If  section  lines  are  superimposed  as  shown,  the  group  index  number  should  be 
as  follows: 


Section 

Group 


1 

2 

4 

5 

6 


No .  of 
Lines 

2 

1 

2 

2 

2 

1 


Channel 
Index  No. 


1 

4 

6 

6 

7 


Figure  32.  (Concluded) 
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Hj-iN  INTEGER 

LEFT  CH  EASTING 

337030  8125 

LEFT  CH  NORTHING 

146973  9063 

RIGHT  CH  EASTING 

336634  0938 

RIGHT  CH  NORTHING 

147024  9063 

BL  EASTING 

337328  4063 

BL  NORTHING 

146935.5938 

CL  EASTING 

336832  5000 

CL  NORTHING 

146999  4063 

SIDE  LEFT  RISE 

1 

SIDE  LEFT  RUN 

5 

SIDE  RIGHT  RISE 

i 

SIDE  RIGHT  RUN 

IS 

| 

PROJECT  DEPTH 

40  ^E)00 

OUERDEPTH 

2  0000 

COMPUTE' 

NOTHING 

MORE  COORDINATES  AFTER 

THESE?  YES 

I  ENTER  CHANNEL  C 

OGRDINATE  PAIR  NO.  1 

Figure  33.  Coordinate  form:  NEW  LINE  INPUT 


accepts  left-side  channel  easting  and  northing,  right-side  channel  easting  and 
northing,  baseline  easting  and  northing,  and  center-line  easting  and  northing 
in  district  units  (feet). 

46.  Section  lines  may  be  defined  by  one  of  three  methods  (Figure  34): 
RECTftHGULAR 


NOHRECT ANGULAR 


Figure  34.  Section  line  definition  methods 
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rectangular,  nonrectangular ,  or  channel  based.  Groups  of  parallel  lines  are 
created  that  are  either  rectangular,  trapezoidal,  or  channel -shaped .  The 
first  form  (Figure  35)  has  an  item  to  select  the  input  method  and  an  item  to 
select  action  on  the  next  group.  The  rectangular  input  method  (Figure  36) 
generates  lines  of  fixed  length  parallel  to  the  first  at  uniform  offset.  The 
nonrectangular  input  method  generates  linearly  increasing  or  decreasing  length 
parallel  to  the  first  at  uniform  offset.  In  addition  to  all  form  items  re¬ 
quired  for  the  rectangular  method,  a  second  line  (Figure  37)  must  be  defined 
by  start  and  end  coordinates  for  use  as  a  reference  for  determining  the  azi¬ 
muths  of  propagation  from  the  ends  of  the  first  line.  The  channel-based  input 
method  (Figure  38)  uses  the  channel  coordinates  as  a  reference  for  section 
line  generation.  Once  all  groups  are  input,  a  graphical  representation  of  the 
channel  is  displayed  (Figure  39)  . 

47.  The  EQUIPMENT_ENTRY  program  allows  entry  of  transponder  easting, 
northing,  and  height  (Figure  40).  The  boat  antenna  height  is  also  entered 
(Figure  41).  An  option  of  using  or  not  using  depth  chart  event  marking  is 
allowed.  The  type  of  range  and  depth  equipment  to  be  used  must  be  selected. 
One  equipment  option  is  SIMULATION;  this  allows  depth  equipment  to  be 
exercised  while  ranges  are  simulated  (vice  versa)  for  diagnostic  purposes. 

48.  The  FIND_SP0T  style  survey  requires  running  the  EQUIPMFNT_ENTRY 
program  and  the  NEW_SPOT_INPUT  program  prior  to  beginning  the  survey.  The 
Louisville  style  requires  no  presurvey  programs. 

49.  The  NEW_SP0T  INPUT  program  simply  allows  inputting  a  series  of  co¬ 
ordinate  parrs  (Figure  42)  corresponding  to  the  desired  spots  to  be  located. 
The  output  goes  to  a  file  with  the  site  name  and  the  extension  ".SPOT." 

50.  Several  programs  have  been  developed  to  verify  system  operation. 
These  programs  are  normally  run  when  there  is  a  problem  with  the  system  to 
determine  which  component  is  not  functioning  properly. 

51.  Prior  to  going  to  the  survey  site,  a  simulated  run  may  be  done  in 
the  office  and  the  simulated  data  plotted.  This  is  a  good  check  of  the  survey 
coordinates  and  template.  The  simulated  data  may  be  plotted  in  plan  view  and 
cross  section,  making  most  bad  entry  values  stand  out.  It  is  better  to  detect 
and  correct  input  errors  at  the  office  rather  than  the  site  because  there  are 
less  pressure  and  chance  for  error.  This  step  is  not  essential  as  coordinates 
may  be  entered  on  the  survey  boat  as  it  sails  from  the  dock  to  the  survev 
site,  but  is  recommended  whenever  time  allows. 
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SECTION  METHOD 
hCTIOH  on  next  group  modify 


SELECT  SECTION  INPUT  METHOD  FOR  GROUP  1 


Figure  35.  Section  line  input  method  form: 
NEW  LINE  INPUT 


STATION  START 

STATION  INCREMENT 

EASTING  START 

NORTHING  START 

EASTING  FINISH 

NORTHING  FINISH 

SEPARATION 

DIRECTION 

NUMBER  OF  LINES 

CHANNEL  INDEX 

MORE  GROUPS  AFTER  THIS? 


337328 . 4663 

146935.5938 

336336 . 5938 
147063  2031 
500  0000 
LEFT 

31 

1 

NO 


ENTER  ALL  ITEMS  AND  CONFiRM 
LEFT  OR  RIGHT  BASED  ON  STANDING  ON 
LEFT  BhNK  FACING  THE  RIGHT  BANK 


Figure  36.  Rectangular  input  method: 
NEW  LINE  INPUT 


■  A  REAL  NUMBER 


EASTING  START 
NORTHING  START 
EASTING  FINISH 
NORTHING  FINISH 


331813.3125 

234010.9063 

331945.5938 


ENTER  ANY  OTHER  LINE  IN  SECTION 


Figure  37.  Nonrectangular  input  method: 
NEW  LINE  INPUT 


■  A  REAL  NUMBER 


STATION  START 
STATION  INCREMENT 

EXTENSION  BEYOND  CHANNEL  LEFT  SIDE 


yyiuj 
0  0000 


EXTENSION  BEYOND  CHANNEL  RIGHT  SIDE  0.0000 
SEF STATION  200  O08O 

STARTING  CHANNEL  COORDINATE  INDEX  O 
CHANNEL  END  LINES  TO  INCLUDE  BOTH 

MOPE  GROUPS  AFTER  THIS?  NO 


ENTER  ALL  ITEMS  AND  CONFIRM 


Figure  38.  Channel-based  input  method: 
NEW  LINE  INPUT 
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STATION 
0 . 00 


EASTING 

325579.41 


NORTHING 
236195  91 


NO  OUTPUT  FILE 

OUTPUT  FILE  NAME  lARLINCtOR 

PRINT  NOYHIN" 

Figure  39.  Generated  lines:  NEW_LINE_INPUT 


MEa»«IIBiaaa 

EASTING 

33456 . 560 

NORTHING 

121342.60 

1 

HEIGHT 

MORE  TRANSPONDERS  AFTER 

10.0000 

THIS?  YES 

Figure  40.  Transponder  triordinate  form: 
EQUIPMENT_ENTRY 


|«-  SIMULATE  MINIRANGER  GEOOIMETER140 

HHJH  polarf  + 

OUTPUT  FILE  NAME 

ARLINGTON 

RANGE  EQUIPMENT 

rrnrnr 

1 

DEPTH  EQUIPMENT 

INNERSPAUt  001 

BOAT  ANTENNA  HEIGHT 

13.0000 

FIX  MARKS 

FEET 

FIX  MARK  INTERNAL 

1 0  0000 

Figure  41.  Equipment  selection  form: 
EQU I PMENT_ENTRY 
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*  <tH  4:  ♦  4  4 1  f  nttMl  »  *  4  1 4 4  *  4  f  *  4  *  *  *  44  4 4  4  «  UtU 

CODE  RETURN  CONFIRMS  A  FORM 

ESCAPE  'HOT  CODE  ESCAPE  >  ALLOWS  ESChPING 


I  di  1 

EhSTIMG 
NORTHING 
MORE  GROTS 

4 3876  000 

127664  DO 

TO  FIND  AFTER  THIS'  FITS  1 

Sill 

VMM 

Figure  42.  NEW  SPOT  INPUT  form 


Survey 

Section  line  survey 

52.  The  survey  program  is  actually  eight  independent  tasks  that  pass 
information  through  a  common  block  of  memory  and  gain  processor  time  on  a 
prioritized  basis.  To  initiate  the  eight,  run  the  program  SURVEY.  SURVEY 
will  bring  the  other  seven  tasks  (CONFIGURE,  DEPTH,  RANGE,  PILOT, 

PLOT_PLOTTER,  PRINT,  and  PLOT_SCREEN)  Into  memory  and  run  them.  Starting 
SURVEY  spawns  a  temporary  task  called  CONFIGURE  that  reads  in  the  equipment 
and  section  line  files  and  displays  several  short  forms  that  the  operator  may 
modify  from  their  default  values.  The  first  form  displayed  allows  the  opera¬ 
tor  to  select  the  type  of  survey  (predetermined  section  line,  find  spot,  ran¬ 
dom,  or  Louisville  style),  whether  or  not  ranges  and  depths  are  to  be  simu¬ 
lated  or  acquired  from  transponders,  whether  or  not  pilot  guidance  will  be 
used,  whether  or  not  plotting  will  be  used  (plan  view  only  at  present), 
whether  or  not  data  will  be  printed  during  test  (if  so,  time  interval  between 
printouts  is  entered),  type  of  screen  display  (plan  view,  cross  section,  or 
both) ,  and  whether  or  not  all  data  collected  are  to  be  stored  (Figure  43) .  If 
not  all  data  are  to  be  saved,  another  form  (Figure  44)  is  brought  up  in  which 
the  operator  selects  the  method  by  which  acquired  data  are  to  he  decimated  for 
storage , 

53.  The  PLOT_SCREEN  task  accepts  all  run-time  operator  inputs  and  con¬ 
trols  the  screen  display.  The  task  automatically  selects  the  first  line  and 
displays  it  on  the  screen  (Figure  45).  The  top  of  the  screen  is  north,  and 
the  beginning  of  line  is  further  from  the  edge  of  the  screen  than  the  end.  As 
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Figure  43.  Survey  option  form: 

(section  line) 


SURVEY 


■  RATE  IN  SECONDS 


POSITION  AT  LEAST 
POSITION  AT  LEAST 
DEPTH  AT  LEAST  1  0000 

DEPTH  AT  LEAST  5.0000 

DEPTH  AT  LEAST  1 . 0000 


ENTER  DATA  SANE  RATE  PARAMETERS  AND  CONFIRM 


Figure  44.  Data  rate  form:  SURVEY  (section  line) 

easting  i 

325594 . 16 

.  NORTHING 

1  236217.03 

/  OFFSET 

/  -7 . 50 

/  DOWNLINE 

/  25 . 00 

j  SCALE 

/  60  69 

/  DEPTH 

/  28.10 

j  SPEED 

/  2 . 88 

/  MARK  E 

/ .  0 . 00 

/  :  MARK  N 

j  0 . 00 

MARK  D 
0 . 00 
TIME 
16.00 
GOOD  GEOM 
3 AO I NG  DAT A 


Figure  45.  Survey  display: 
SURVEY  (Louisville) 
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each  new  boat  position  is  read,  a  dot  is  displayed  on  the  screen  at  the  proper 
location.  Several  "live"  values  are  displayed  on  the  right  edge  of  the 
screen.  Messages  are  displayed  to  indicate  the  geometry  of  the  positioning 
system  and  if  data  are  currently  being  saved.  A  number  of  run-time  changes 
may  be  initiated  by  the  operator.  To  cause  these  changes  to  take  place,  the 
operator  momentarily  depresses  a  key.  A  aborts  the  run.  C  allows  entering 
initialization  information  for  Cubic  positioning  equipment  if  range  signal  is 
lost  for  extended  period  and  Cubic  must  be  restarted.  D  allows  entering  a 
depth  gage  tide  adjustment.  E  allows  manual  ending  of  data  saving  for  a  line. 
F  enables  or  disables  range  wild  point  filtering.  L  allows  manually  selecting 
the  next  survey  line.  N  allows  changing  the  next  mark  number  from  its  next 
sequential  value.  0  overrides  automatic  "start  at  beginning  of  line  and 
finish  at  end  of  line"  data  saving  (overriding  may  be  toggled  on  and  off  by 
successively  striking  0) .  P  causes  data  collection  to  pause  until  P  is  struck 
again.  Q  causes  the  task  to  quit  immediately.  R  reverses  the  direction  in 
which  the  current  line  is  to  be  run.  T  allows  new  transponder  locations  to  be 
selected  from  the  transponder  menu.  X  exchanges  the  screen  scale. 

54.  Normally,  as  the  beginning  of  line  is  passed,  data  saving  starts 
and  when  the  end  of  line  is  passed,  it  stops.  Data  are  written  to  disk  in  a 
file  with  a  four-digit  extension  which  is  the  same  as  the  line  number.  Then 
tl  ■>  next  sequential  line  is  displayed  and  the  sequence  continues.  If  the  boat 
cannot  manuever  to  the  start  of  line,  S  may  be  entered  to  start  data  collec¬ 
tion  at  the  present,  down-line  position.  If  the  boat  cannot  reach  the  end  of 
line,  E  may  be  entered  to  terminate  the  data  collection  at  the  present  posi¬ 
tion.  M  causes  the  current  easting,  northing,  depth,  and  time  to  be  saved. 

B  causes  a  position  offset  by  some  entered  distance  and  angle  to  be  saved. 
Sometimes  it  is  desirable  to  enter  R  and  reverse  the  line  to  make  boat  steer¬ 
ing  easier  due  to  currents  or  wind.  If  depth  chart  event  marking  was  selected 
in  the  equipment  file,  event  marks  are  generated. 

Louisville  style  survey 

55.  Louisville  style  survey  uses  a  scaled  cartesian  coordinate  system 
which  is  not  absolutely  defined  in  terms  of  easting,  northing,  or  rotation. 
Like  the  section  line  survey,  the  survey  task  is  actually  eight  independent 
tasks  that  pass  information  through  a  common  block  of  memory  and  gain  proces¬ 
sor  time  on  a  prioritized  basis.  The  first  form  displayed  allows  the  operator 
to  select  the  type  of  survey — Louisville  style  (Figure  46).  The  task  then 
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Figure  46.  Survey  option  form:  SURVEY  (Louisville) 


displays  a  Louisville  style  input  form  (Figure  47).  Items  entered  include 
pool  elevation  (subtracted  from  depths  during  the  run),  bar  identification 
number,  transponder  separation,  and  plot  scale. 


Figure  47.  Louisville  special  form: 
SURVEY  (Louisville) 


56.  The  PLOT_PLOTTER_LOUISVILLE  task  first  asks  the  operator  to  posi¬ 
tion  the  plotter's  pen  at  transponder  S's  relative  location  and  enter  a  car¬ 
riage  return.  It  puts  the  B  transponder  symbol  at  this  point.  It  then  asks 
the  operator  to  position  the  pen  at  transponder  -4's  relative  location  and 
enter  a  carriage  return.  The  task  then  uses  the  second  operator-selected 
position  to  determine  an  azimuth  from  transponder  B  to  transponder  A.  It  then 
moves  to  transponder  d's  plot  position  along  this  azimuth  a  distance  equal  to 
the  plot  relative  transponder  separation  and  plots  the  A  transponder  symbol. 
Next  it  generates  an  easting,  northing  set  of  transponder  coordinates  based  on 
the  plotter  input  transponder  coordinates.  The  PLOT_SCREEN_LOUISVILLE  task 
accepts  all  run-time  operator  inputs  and  controls  the  screen  display.  The 
task  automatically  creates  a  line  based  on  present  position  and  displays  it  on 
the  screen  (Figure  48). 

57.  A  program  called  SECTION  LINES_LOUISVILLE  will  take  the  data  and 
generate  a  pseudo  .LINE  file  to  make  it  resemble  a  section  line  survey.  It 
also  modifies  the  distance  along  line  and  distance  off  line  in  the  data  files 
to  correspond  to  the  pseudolines  it  created.  This  allows  the  postprocessing 
programs  to  be  used  with  data  collected  in  this  manner. 

Random  survey 

58.  Random  survey  style  is  a  superset  of  the  section  line  survey. 
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Figure  48.  Survey  display: 
SURVEY  (Louisville) 


There  are  two  major  operational  modes:  (a)  RUN  and  (b)  CHANNEL. 

59.  RUN  mode  is  the  same  operationally  as  the  section  line  survey  with 
the  addition  of  three  more  key  commands  (Y ,  Z,  and  Q) .  Y  and  Z  are  used  to 
mark  a  reference  line  for  use  in  line  generation  by  the  rectangular  method 
previously  described.  Y  marks  the  start  of  line  (left  side)  and  Z  marks  the 
end  of  line  (right  side) .  Q  is  used  to  exit  run  mode  and  return  to  the  main 
menu. 

60.  CHANNEL  mode  is  used  to  establish  new  channel  coordinates  or  change 
old  ones.  Coordinates  are  sampled  at  the  current  boat  position.  The  coordi¬ 
nates  are  marked  at  channel  bends  in  the  same  manner  as  in  the  NEW_LINE_INPUT 
program.  Key  commands  are  pertinent  to  the  present  channel  coordinate  index. 

L  marks  the  left  side  of  the  channel;  R  marks  the  right.  C  marks  the  center 
line  and  B  the  baseline.  N  saves  the  present  channel  coordinate  pairs  and 
advances  to  the  next  index.  J  jumps  back  to  a  previous  index.  E  ends  an 
index  and  Q  returns  to  the  main  menu.  The  main  menu  allows  selecting  CHANNEL 
or  RUN  mode.  Also  lines  may  be  generated  from  the  reference  line  or  the  most 
recent  line  run.  When  finished,  Q  is  entered  to  end  the  program  and  update 
the  .LINE  file. 

61.  The  modules  are  the  same  as  for  section  line  surveys  with  one 
change:  the  module  RANDOM  replaces  PLOT  SCREEN. 
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Find  spot  survey 

62.  A  find  spot  survey  is  used  to  locate  a  number  of  predetermined  co¬ 
ordinate  positions.  It  is  similar  to  a  section  line  survey  except  that  a 
point  rather  than  a  line  is  displayed  on  the  screen.  A  subset  of  the  section 
line  key  commands  is  used  (A,  B,  C,  D,  E,  L,  M,  N,  T,  Q,  and  X) .  These  keys 
nave  the  same  meauxiig  as  in  Liie  section  lin^.  survey  . 

63.  The  modules  are  the  same  as  for  section  line  surveys  with  two 
changes.  The  module  FIND_SPOT  replaces  PLOT_SCREEN  and  the  module 
PILOT_FIND_SPOT  replaces  PILOT.  The  change  in  the  latter  module  is  required 
because  pilot  guidance  uses  correction  in  heading  in  degrees  (-180  to  +180)  in 
place  of  distance  off  line  (left  or  right). 

Data  acquired  by  other  means 

64.  The  MANUAL_SURVEY_ENTRY  program  allows  entering  depths  from  key¬ 
board  at  a  fixed  distance  along  the  line  interval.  The  operator  enters  the 
desired  distance  along  the  line  interval  in  feet  and  the  line  number  to  be 
entered.  Next  the  program  prints  the  distance  along  the  line  and  asks  for 
depths . 

65.  The  DIGITIZE_DEPTH_CHART  program  allows  digitizing  data  via  a  Sum- 
magraphics*  tablet  digitizer  from  a  hard-copy  depth  plot.  (It  may  be  used  for 
depth  charts  if  the  boat  is  travelling  at  a  constant  speed  or  variable  speed. 
Nonlinear  distance  along  the  line  is  supported.)  This  program  automatically 
rotates  the  coordinate  system  as  needed. 

Postsurvey 

66.  There  are  several  programs  available  to  postprocess  survey  data. 

The  programs  may  be  used  with  data  collected  by  any  of  the  four  survey 
methods,  the  keyboard  entry  method,  or  the  digitizer  input  method.  These 
include  list  programs,  adjustment  programs,  cross-section  and  quantity 
programs,  and  plan  views. 

List 

67.  READ_DATA,  READ_MARKS ,  and  READ_TIDE  list  data,  mark,  and  depth 
adjustment  files,  respectively.  PRINT_DATA  and  PRINT_MARKS  print  data  and 
marks,  respectively. 


*  Summagraphics  is  a  registered  trademark  of  Summagraphics  Corporation. 
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Data  adjustment 

68.  There  are  several  data  adjustment  programs  available. 
ADJUST_DEPTHS_FOR_TIDE  allows  either  a  fixed  tide,  stepped  tides,  or  linearly 
interpolated  tide  values  to  be  subtracted  from  the  data.  RAW_DATA_TO_TEXT 
converts  the  binary  raw  data  to  an  American  Standard  Code  of  Information 
interchange  (.ascii)  iorm  that  can  be  mouified  by  the  text  editor  (file  name 
TEXT) . 

69.  EDIT_DATA  is  a  program  to  edit  surveyed  data  graphically  for  bad 
depth  removal  and  for  extension  beyond  existing  data  bounds.  The  program  is 
designed  to  allow  deletion  of  data  on  the  existing  depth  versus  distance  along 
line  curve  and  addition  of  data  beyond  curve  limits.  The  program  asks  for  the 
site  name  and  whether  or  not  a  template  is  to  be  displayed.  The  template 
should  not  be  displayed  on  profile  lines,  only  on  cross-section  lines.  The 
first  acquired  line  is  then  displayed  in  cross-section  graphical  form  and  the 
arrow  keys  can  be  used  to  position  the  crosshairs  over  the  point  of  interest; 
when  on  the  curve  only,  the  left-right  arrows  work  and  up-down  motion  follows 
the  curve. 

Cross  sections  and  quantities 

70.  The  CROSS_SECTION_DESCRIPTION  program  accepts  inputs  from  keyboard 

and  writes  them  out  to  a  file  with  extension  CROSS.  It  asks  what  is  to  be 
done:  screen  plots,  printer  plots,  plotter  plots,  quantities  to  screen,  and 

quantities  to  printer.  It  requests  the  pen  number  for  the  templates,  allowed 
side  slopes,  center  lines,  surface,  letters,  predredge  depths,  and  postdredge 
depths.  Selecting  DO  NOT  PLOT  will  indicate  that  this  item  is  to  be  omitted. 
The  program  then  asks  letter  si*. .2  and  scales. 

71.  The  CROSS_SECTION_AND_DREDGING  program  displays  cross  sections 
(Figures  21  and  49)  on  screen,  printer,  or  plotter.  Computations  include 
areas  within  templates,  within  the  allowed  side  slope,  and  between  surveys. 
Volumes  and  cumulative  volumes  are  computed  using  these  areas. 
MOBILE_QUANTITY_FORMAT  consolidates  the  data  for  presurveys  and  postsurveys 
and  MOBILE_SINGLE_FORMAT  for  single  surveys.  Three-dimensional  stacked  cross 
sections  may  be  displayed  and  plotted.  3D_MAKE  is  run  to  generate  data  on  a 
mesh  and  3D_PL0T  is  used  to  plot  it  (Figure  22) . 

72.  Quantities  may  also  be  computed  using  the  National  Bureau  of 
Standards/Engineering  Topographical  Laboratory  algorithm  (Bernal  1988) . 

TEMPI ATF  makfr  and  XV7  gpnerare  -input  data.  TOP  and  DRE  use  a  triangular  mesh 
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Figure  49.  Cross  section  and  dredging  volumes 

to  compute  a  single  volume  of  material  within  the  channel  template. 

73.  The  PLAN_VIEW_PLOT_DESCRIPTION  program  accepts  inputs  from  keyboard 
and  writes  them  out  to  a  file  with  extension  PLAN.  It  requests  the  pen  number 
for  the  center  lines,  channel  lines,  baselines,  depths,  legends,  section 
lines,  grid  marks,  north  arrow,  and  transponders.  Plot  scale,  rotation  angle, 
and  contouring  information  are  entered. 

74.  The  DIGITIZE_PLOTTER  and  D I GI T I Z E_FEATURE S  programs  allow  digitiz¬ 
ing  features  via  a  plotter  or  digitizing  tablet,  respectively,  from  a  hard¬ 
copy  plan  view.  These  programs  automatically  rotate  the  coordinate  system  as 
needed.  The  PLAN_VIEW_PLOTTER  (Figure  20)  program  plots  channels,  lines, 
data,  features,  screen  image  pictures,  user-generated  labels,  and  an  automati¬ 
cally  generated  and  sized  legend.  The  PLAN_VIEW  program  (Figure  50)  is  iden¬ 
tical  to  PLAN_T,  IEW_PLOTTER  except  that  it  additionally  produces  contours  via  a 
triangular  mesh  (Hamm,  Kibler,  and  Morris  1975)  fitted  to  300  points  of  the 
averaged  data  and  interpolated  by  a  fifth-order  bivarient  polynomial  fit 
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(Akima  1975).  Further  information  on  combined  fit  algorithm  be  obtained 
in  Tr-cv  (1983).  There  are  also  programs  for  plotting  features  and  user¬ 
generated  labels  that  do  not  require  a  survey  site  or  data;  these  are  used  for 
general-purpose  computer-aided  map  (CAM)  generation.  EDIT_FEATURES  is  a  pro¬ 
gram  that  allows  maps  to  be  input  and  graphically  edited  using  a  digitizing 
tablet  and  arrow  keys  (similar  to  computer-aided  design  packages;  i.e.,  stamps 
of  lighthouses,  Corps  emblems,  etc.,  may  be  saved  and  restored,  rotated,  and 
scaled  on  new  maps) . 


District  Assistance 


75.  Several  Districts  funded  enhancements  to  their  particular  survey 
systems.  This  had  the  effect  of  broadening  the  capabilities  of  the  software 
package  developed  for  Corps-wide  use.  Their  contributions  are  summarized. 
Mobile 

76.  Since  the  software  package  provided  under  HQUSACE  funding  was  lim¬ 
ited,  Mobile  District  chose  to  fund  a  number  of  enhancements  and  additions. 
Most  of  these  dealt  with  input  of  data  from  sources  other  than  the  survey  pro¬ 
gram.  These  included  (a)  a  keyboard  data  input  program,  (b)  a  digitizing  tab¬ 
let  strip  chart  data  input  program,  (c)  a  digitizing  tablet  features  input 
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program,  (d)  a  Topcon*  data  logger  to  data  program,  and  (e)  a  Topcon  data 
logger  to  features  program.  The  District  also  funded  inclusion  of  several 
position  and  depth  systems,  conversion  programs  to  transfer  data  to  existing 
processing  programs  on  Mobile's  Harris**  computer  enhancements  to  plotting  new 
programs,  CAM  enhancements,  and  new  dredging  output  formats. 

77  M~v,-ne  Area  Office  and  Panama  City  Area  Office  have  been  instru¬ 
mental  in  bringing  the  software  to  field  readiness.  The  personnel  at  these 
two  sites  have  been  very  cooperative  and  understanding  of  problems  associated 
with  the  development  and  are  to  be  commended  for  their  steadfastness  in  field 
debugging. 

Louisville 

78.  The  Louisville  and  Huntington  Districts  were  interested  in  develop¬ 
ing  a  quick  survey  method  by  which  scaled  data  without  control  point  reference 
could  be  collected.  Louisville  funded  modifications  to  the  existing  section 
line  style  survey  used  at  Mobile.  This  included  modifications  to  the  survey 
program,  conversion  programs  to  transfer  data  to  existing  Harris  computer  pro¬ 
grams,  and  a  program  to  generate  some  pseudosection  lines  so  that  postprocess¬ 
ing  programs  could  be  used.  Fortunately,  because  Mobile  had  ironed  out  most 
of  the  bugs  in  the  package  before  Louisville  became  involved,  only  minor 
debugging  was  required. 


*  Manufactured  by  the  Topcon  Instrument  Corporation  of  America. 

**  Harris  is  a  registered  trademark  of  the  Harris  Corporation. 
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PART  IV:  FINAL  DEVELOPMENT  CONCLUSIONS 


Hardware 


79.  Two  different  range-azimuth  systems  (Hydro  1  manual  system  by  IMC 
_al  Polarfl..  automated  system  by  Krupp  Atlas)  were  found  to  work  well  w* th  the 
rest  of  the  small-boat  hydrographic  survey  system.  Both  give  data  age  along 
with  position  so  that  time  of  position  sent  can  be  determined  within  0.1  sec, 
and  both  tracked  well  in  field  tests.  The  Hydro  1  gives  position  and  the  age 
of  the  data  as  referenced  to  the  Grid  System  computer's  quiz  character;  the 
Polarfix  gives  a  predicted  position  at  the  time  of  the  quiz  character  and  data 
age  to  show  how  old  the  last  position  was.  For  the  Hydro  1,  the  age  is  sub¬ 
tracted  from  the  time  the  quiz  character  was  sent;  for  the  Polarfix,  ages 
greater  than  4  sec  indicate  the  position  is  questionable  and  the  corresponding 
position  is  discarded.  In  this  way  the  time  of  position  is  accurately  ob¬ 
tained  so  that  depth  and  position  are  correlated  accurately.  This  is  impor¬ 
tant  because  if  a  boat  running  cross  sections  were  moving  at  10  fps,  a 
position-time  error  of  1  sec  would  effectively  move  the  channel  10  ft  to  one 
side.  Other  range-azimuth  systems  should  work  well  also,  but  ease  of  tracking 
and  time  of  position  should  be  investigated  before  purchasing.  A  number  of 
range-range  systems  are  presently  in  use.  The  addition  of  "space  diversity" 
(i.e.,  two  boat-mounted  transponders  and  electronic  control  circuitry)  to 
eliminate  "range  holes"  is  highly  recommended.  Pilot  guidance  over  calm 
waters  is  smooth  with  this  feature,  but  highly  erratic  without  it.  The  posi¬ 
tion  system  with  space  diversity  selects  the  shortest  path  return  signal  in  a 
multipath  environment.  Multirange  systems  could  be  added  with  minor  software 
changes  but  should  also  have  space  diversity,  as  having  multiple  shore  sites 
alone  will  do  little  to  correct  for  multipath  problems. 

80.  The  setup  that  is  easiest  to  use  is  configuration  2,  equipment  on 
the  boat  (Figure  10).  Therefore,  if  the  boat  is  large  enough  to  support  this 
configuration,  it  is  recommended.  This  setup  is  easier  to  use  because  there 
is  less  hooking  and  unhooking  of  electrical  equipment.  Most  of  the  equipment 
is  on  the  boat  and  can  be  left  cabled  together.  Also  some  shore  sites  are 
hard  to  reach  and  carrying  the  minimal  amount  of  equipment  to  the  shore  is 
desirable.  For  shallow  water,  where  a  small  flat-bottom  boat  is  used,  con¬ 
figuration  1  (Figure  9)  may  be  the  best  solution.  Fewer  components  are 
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required  on  the  boat,  yet  pilot  guidance  and  on-line  plotting  are  still  avail¬ 
able.  This  is  a  particularly  good  configuration  for  theodolite  type  position¬ 
ing  systems  that  require  only  a  prism  array  on  the  boat  end. 


Software 

81.  Small-boat  hydrographic  survey  software  for  many  survey  needs  has 
been  developed.  Data  acquisition,  pilot  guidance,  and  all  postprocessing 
software  are  run  on  the  same  computer.  The  package  was  designed  to  be 
friendly,  yet  powerful.  Good  defaults  are  provided  for  most  plot  control 
entries  with  form-driven  user  modification.  The  package  is  modular  and  can  be 
used  with  a  variety  of  vendor  equipment  (although  each  item  should  be  verified 
for  support  before  purchase).  Several  cross-section-style  survey  methods  are 
supported;  sweep  system  surveys  are  not  presently  supported  but  could  be 
added.  Presently  such  corrections  for  boat  motion  as  yaw,  pitch,  roll,  or 
vertical  displacement  are  not  supported  in  software.  This  type  of  correction 
would  allow  correcting  depths  for  wave  action  and  boat  squat.  Since  the  soft¬ 
ware  is  modular,  it  would  not  require  a  large  effort  to  include  these  highly 
desirable  corrections.  Since  small  boats  are  not  normally  used  in  rough 
water,  these  corrections  for  boat  motion  were  not  explored. 

82.  Tide  adjustment  data  may  presently  be  time  marked  at  the  time  the 
operator  enters  them.  There  are  a  number  of  automated  tide  stations  capable 
of  sending  data  to  a  computer;  so  automated  tide  collection  and  application 
may  be  a  future  enhancement  if  funded. 

Overall 


83.  The  small-boat  hydrographic  survey  system  software  is  available 
free  of  charge  through  the  WES  Engineering  Computer  Programs  Library*  to 
Government  agencies;  this  software  is  also  available  to  non-Government  agen¬ 
cies,  but  they  must  supply  the  blank  diskettes  on  which  the  programs  are  to  be 
recorded.  The  software  is  updated  regularly  to  include  enhancements  and  new 
equipment  modules,  and  to  correct  any  user-discovered  bugs  or  peculiarities. 

*  Engineering  Computer  Programs  Library,  Customer  Assistance  Group,  Informa¬ 
tion  Technology  Laboratory  (CEWES-IM-SC) ,  3909  Halls  Ferry  Road,  Vicksbu.g, 
MS  39180-6199. 
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Consultation  to  Government  agencies  can  be  provided  by  WES.  Consultation  to 
non-Government  agencies  is  not  available  unless  they  are  operating  mder  a 
Government  contract. 

84.  Hardware  is  available  directly  from  the  vendors.  An  effort  will  be 
made  by  WES  to  support  as  m-ny  systems  as  possible;  however,  since  certain 
criteria  must  be  met  oy  the  vendor,  it  is  best  to  check  on  compatibility.  It 
was  not  part  of  the  scope  of  this  report  to  evaluate  vendor  equipment;  how¬ 
ever,  systems  used  are  diagrammed.  The  development  was  carried  out  to  ensure 
that  at  least  one  system  for  small  survey  boats  would  be  available  and  to 
demonstrate  the  Corps'  need  of  these  type  systems  to  induce  vendor  involve¬ 
ment.  Several  vendors  have  responded  favorably,  and  more  hardware  is  avail¬ 
able  or  under  development. 

85.  The  two  biggest  successes  of  this  project  are  (a)  development  of  a 
powerful,  easy-to-use,  widely  applicable  software  package  and  (b)  the  encour¬ 
agement  of  vendor  development  of  hardware  suitable  for  small-boat  systems. 

Side  effects  include  a  potential  for  standardized  Corps  practices,  ability  to 
collect  quantities  of  quality  data,  and  common  processing  procedures  across 
the  Corps.  Adoption  of  Corps-wide  standards  would  reduce  grounds  for  dispute. 
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Table  1 

Minimum  Hardware  Required 


Essential : 

(1)  Grid*  1129  or  1139  computer** 

(2)  Grid  2101  disk  drive  (with  20-megabyte  hard  disk** 
upgrade) ,  double-sided  double-density  diskettes 

(3)  IEEE488  cable  to  connect  (1)  and  (2)  (approximately  3  ft) 

(4)  Serial  cable  Grid  number  6100** 

(5)  RJ1 1  phone  line  (standard  modular  plugs  both  ends,  approximately  20  ft) 

(6)  Grid  OS,*  Grid  Term,*  and  Grid  Paint*  software  on  floppy  (optionally 
FORTRAN,  MS-DOS ,t  etc.**) 

(7)  RS232  positioning  system  with  RS232  cable  (WES-made  cable) 

(8)  IEEE488  depth  system  with  IEEE488  cable 

For  Pilot  Guidance: 

(9)  TRS80  Radio  Shack)  Model  102  Executive  Workslate 

(10)  AC  adapter  for  (9),  Radio  Shack  26-3804 

(11)  Modem  cable  for  (9),  Radio  Shack  26-1410 

For  Plotting: 

(12)  Hewlett-Packard  (HP)  plotter  (preferably  model  Draftmaster  for  office 
or  Draftpro  for  field) 

(.13)  IEEE488  cable  for  (12)  (12  ft  approximately)  and  pens/paper 

For  Phoning  from  Hotel  Rooms  through  Operator: 

(14)  Grid  Handset*,** 

For  Digitizing  Data  from  Depth  Charts,  Maps,  etc.: 

(15)  Summagraphics  Bit  Pad  1  (small)  or  Summagraphics  Microgrid  (large) 

(16)  RS232  cable  for  digitizer  (WES  made) 

For  Digitizing  Data  from  Plotter  (slow  and  not  recommended) : 

(17)  Digitizing  sight  (either  straight  or  angled) 

To  Aid  in  Producing  Logos,  etc.,  for  Inclusion  on  Plots: 

(18)  Grid's  version  of  Mouse  System's  mouse**/' 

For  Printing: 

(19)  HP  Thinkjet,  Laserjet  II,  or  many  Epson^  models 
Fcr  Really  Rough  Waters: 

(20)  Targa  Electronics  Systems,  Inc.,  bubble  (3101)  or  nonvolatile  ram 

cartridge  storage  units — specify  Grid  interface  IEEE488** 

(Continued) 


*  Registered  trademark  of  Grid  Systems  Corporation. 

**  Recently  the  software  was  rewritten  to  run  on  MS-DOS  PC-compatible  sys¬ 
tems.  Minimum  computer  hardware  may  now  be  an  MS-DOS  computer  (e.g.,  Grid 
1535)  with  Hayes-style  modem  on  C0M1 : ,  RS232  serial  port  COM2:,  640  kbytes 
memory,  CGA  graphics  capability  (most  EGA  and  VGA  cards  support  this), 
National  Instruments  PC2A  IEEE488  card,  and  8087  coprocessor.  Software 
requirements  are  MS-DOS  and  Intergrid  (with  optional  programs), 
t  MS-DOS  is  a  registered  trademark  of  Microsoft,  Inc. 

It  The  Grid  version  of  Mouse  System's  Mouse  is  a  registered  trademark  of  Grid 
Systems  Corporation, 

*  Epson  is  a  registered  trademark  of  the  Seiko  Epson  Corporation. 


Table  1  (Concluded) 


For  Locating  Equipment  on  Shore: 

(21)  Motorola  (or  others)  radio  links  (check  with  WES) 

For  Brightly  Lit  Survey  Sites  (which  is  almost  everywhere) : 

(22)  Sunscreen  tinted  mylar  for  boat  cabin  windows  to  reduce  glare 


APPENDIX  A:  DEPTH  AND  RANGE  SYSTEMS 


Depth  Sounders 

1.  The  depth  sounders,  commonly  used  for  acquiring  the  distance  from 
the  water  surface  to  the  bottom,  are  sonic  in  nature.  A  burst  of  vibratory 
energy  is  emitted  from  a  transducer  located  on  the  hull  of  the  boat  (prefera¬ 
bly  directly  beneath  the  positioning  system  antenna).  The  transit  time  be¬ 
tween  the  release  of  this  burst  and  the  first  returned  energy  above  a  certain 
threshold  amplitude  is  taken  to  be  the  time  of  travel  to  the  bottom  and  back. 
This  time  is  then  divided  by  two  to  get  the  one-way  travel  time,  and  depth  is 
calculated  from  the  equation: 


DEPTH  =  SPEED  OF  SOUND 


Time\ 

2/ 


+  DRAFT  -  TIDE 


(Al) 


The  draft  of  the  boat  is  added  to  compensate  for  the  depth  of  the  transponder 
from  the  surface.  The  raw  depth  is  tide  adjusted  to  some  reference  plane  by 
subtracting  the  local  tide  for  the  area  surveyed. 

2.  The  particular  frequency  used,  beam  angle,  and  peak  selection 
algorithm  affect  the  depth  obtained  on  anything  but  smooth,  hard  riverbeds. 

The  frequency  used  influences  the  depth  reading  on  soft  bottoms  or  in  areas 
having  suspended  sediment.  The  lower  the  frequency,  the  better  energy 
penetrates  suspended  material  and  soft  bottoms.  However,  lower  frequencies 
require  bigger  transducers  and  subsequently  result  in  larger  beam  angles.  The 
beam  angle  is  important  because  it  determines  the  size  of  the  footprint  on  the 
bottom.  The  wider  the  angle,  the  bigger  the  footprint;  also,  the  deeper  the 
bottom,  the  bigger  the  footprint.  Since  most  commercial  digitizers  normally 
use  the  first  returned  peak,  they  will  usually  pick  up  the  highest  peak  on  the 
bottom  within  the  beam  footprint.  This  tends  to  stretch  the  peak  areas  to 
nearly  the  width  of  the  footprint.  Since  the  two  problems,  penetration  and 
footprint  size,  are  diametrically  opposite  in  solution,  a  compromise  must  be 
reached.  Most  Districts  use  narrow-beam  (2-8  deg)  tranducers  at  about 

200  kHz.  Interface  to  this  type  system  was  designed  into  the  package. 

3.  The  software  expects  a  digitizer  that  can  measure  and  transmit 
depths  at  about  10  times  per  second.  Rapid  updates  are  necessary  on  the  banks 
of  rivers  to  properly  resolve  the  rapidly  changing  side  slope.  To  ensure 
readings  at  this  rate,  digitizers  are  interfaced  by  a  parallel  digital 
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input/output  method,  the  IEEE488  interface  (Institute  of  Electrical  and  Elec¬ 
tronics  Engineers  (IEEE)  Standards  Board  1978).*  This  provides  data  transfer 
at  much  higher  rates  (up  to  1  million  bps)  than  serial  methods  (which  gener¬ 
ally  transmit  at  120  to  960  bps).  Another  reason  for  requiring  the  depth  sys¬ 
tem  to  be  interfaced  via  IEEE488  is  that  the  particular  computer  used  in  the 
small-boat  system  has  only  one  serial  interface,  which  is  devoted  to  the 
slower  position  information. 


Positioning  Systems 

4.  Position  is  another  critical  parameter  that  must  be  measured  ac¬ 
curately  during  hydrographic  surveys.  Obstructions  to  boat  traffic  must  be 
identified  by  location  for  avoidance  and/or  removal.  There  are  a  number  of 
types  of  electronic  positioning  methods  in  use  by  surveyors:  range-range, 
range-azimuth,  and  absolute  positioning. 

Range-range 

5.  Range-range  systems  usually  involve  radio  links  between  one  or  two 
ship-mounted  transponders  and  two  or  more  shore-mounted  transponders.  In  nor¬ 
mal  range-range  calculations  only  one  ship  transponder  and  two  shore  transpon¬ 
ders  are  used.  The  ship  unit  typically  broadcasts  a  pulse  of  radio  frequency 
energy.  The  two  shore  units  receive  the  pulse  and  after  a  short  delay  each 
returns  a  pulse  of  energy.  The  turnaround  delay  in  the  shore  unit  is  constant 
for  a  particular  shore  unit.  The  adjusted  transit  time  divided  by  two  is  used 
to  compute  the  one-way  distance  between  the  boat  and  the  shore  station  by  the 
following  equation: 


where 


DISTANCE  =  SPEED  OF  WAVE  PROPAGATION  x  TIME 


TIME 


(TOTAL  TIME  -  TURNAROUND  DELAY) 
2 


(A2) 


The  method  for  range-range  position  determination  is  shown  in  Figure  Al.  The 
software  uses  the  distances  separating  the  boat  from  two  shore  stations  of 
known  position  to  calculate  boat  position  via  triangulation.  Two  transponders 


*  All  references  cited  in  this  Appendix  are  included  in  the  References  at  the 
end  of  the  main  text. 
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a.  Transponder  line  projection  to  reference  plane 


1.  Compute  the  length  and  angle  of  the  transponder 
coordinates  projected  on  the  zero-height 
reference  plane. 


a.  Compute  the  projected  length: 


JRG 


-  ER 


RG 


ng'nr 


>/= 


2  +E2 

RG  ^RG 


b.  Compute  the  projected  angle: 


RG 

AZMI  =  arc  tan  — — 
ERG 


(1) 

(2) 

(3) 


(4) 


Figure  A1 .  Computing  boat  position  given  a  range- 
range  positioning  system  (Sheet  1  of  3) 


Projection 


Reference  plane 
(height  =  0) 

b.  Range  to  reference  plane 

2.  Compute  the  projected  length  of  the  acquired 
ranges  on  the  zero-height  reference  plane. 

a.  Use  the  Pythagorean  theorem  to  project  the 
reading  of  the  green  transponder's  range 
R„  : 


sa\/rg  "  (Hc  "  hb)2 


b.  Use  cue  Pythagorean  theorem  to  project  the 
reading  of  the  red  transponder's  range 


SB  %/RR  "  (HR  "  HB/2 


V  / 

\  / 

\  / 

S.  \  /  sc 

\  / 

\ AZM4/ 

\  / 

\/  AZMI 


where  SA  ,  S„  ,  and 
Sc  are  sides  of  the 
range  triangle 


c.  Conversion  of  range-range  to  range-azimuth 

3.  Use  law  of  cosines  to  transform  range-range  to 
range-azimuth  relative  to  transponder  line  angle: 


Figure  A!.  (Sb°et  2  of  3) 
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AZM4  «  arc  cos 


(7) 


-  St  +  S 
T¥" 


4.  Add  transponder  angle  to  relative  azimuth  to  get 
absolute  azimuth: 


If  survey  field  =  R  ,  then 

AZM5  =  AZMI  -  AZM4  (8) 

If  survey  field  =  L  ,  then 

AZM5  =  AZMI  +  AZM4  (9) 


5.  Convert  from  polar  to  rectangular  coordinates  to 
get  boat’s  easting  and  northing  relative  to  the 
red  transponder: 

EQ  =  A  cos  AZM5  (10) 

NQ  =  A  sin  AZM5  (II) 

where 


Eg  =  eastward  offset  of  boat  from  red 
transponder 

*  northward  offset  of  boat  from  red 
transponder 


6.  Add  relative  coordinates  to  green's  coordinates 
to  get  boat's  position: 


eb  -  Eo  +  er 


N  =  N  +  N 
B  0  R 


(12) 

(13) 


Figure  Al.  (Sheet  3  of  3) 
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(space  diversity)  are  used  on  the  boat  to  lessen  the  effect  of  multiple  trans¬ 
mission  paths.  The  wave  propagation  between  boat  and  shore  transponders  may 
not  necessarily  take  a  direct  path  between  the  two  points.  It  may  reflect  off 
the  water  and  take  a  longer  path.  Using  two  receivers  separated  by  a  wave¬ 
length  usually  causes  one  of  the  receivers  to  get  a  direct  path  return.  Hard¬ 
ware  in  the  positioning  system  selects  the  first  return  or  stronger  return, 
which  will  correspond  to  the  shorter  path,  and  passes  its  distance  to  the  com¬ 
puter.  The  two  transponders  on  the  boat  will  generally  provide  immunity  to 
range  holes  and  give  improved  accuracy  and  stability  in  pilot  guidance. 

6.  Use  of  multiple  shore  stations  has  the  potential  for  improving  posi¬ 
tion  calculations,  if  properly  done.  A  number  of  carefully  calibrated,  pro¬ 
perly  located  shore  stations  will  give  confidence  due  to  redundancy,  if  the 
positional  error  is  small.  When  more  than  two  shore  stations  are  used,  two 
methods  are  commonly  used  for  calculating  position.  One  method  uses  a  least 
squares  fit  to  all  ranges  (sometimes  weighting  them  based  on  accuracy  of 
geometry) .  This  approach  uses  distances  that  are  known  to  be  inaccurate  and 
will  thus  give  a  less  than  ideal  position;  however,  it  does  give  an  accuracy 
factor  that  allows  the  surveyor  to  have  some  feel  about  how  much  positional 
error  he  might  be  getting.  Software  should  alert  the  operator  if  this  error 
exceeds  a  preset  limit.  The  other  method  is  to  let  the  computer  select  which 
of  the  shore  stations  gives  the  best  triangulation  geometry  and  use  them  in  a 
particular  area. 

7.  Since  the  surveyor  is  trained  in  selecting  shore  positions  that  will 
give  accurate  geometry  and  has  a  knowledge  of  which  shore  transponders  are 
operating  best,  the  small-boat  survey  system  software  uses  only  two  shore  sta¬ 
tions  that  are  selected  by  the  surveyor,  not  the  computer,  at  present.  Since 
this  requires  that  only  two  transponders  be  calibrated  and  accurately  posi¬ 
tioned  at  known  shore  coordinates  (in  practice),  the  chances  of  getting  ac¬ 
curate  positions  may  actually  be  improved  as  the  surveyor  often  has  a  limited 
amount  of  time  to  calibrate,  set  the  transponders,  and  acquire  the  data.  Two 
carefully  calibrated,  properly  located  shore  stations  will  give  better  posi¬ 
tional  accuracy  than  a  number  of  poorly  located  or  calibrated  redundant  shore 
stations . 

Range-azimuth 

8.  Range-azimuth  positioning  systems  measure  distance  from  a  shore  site 
to  the  boat  and  the  vertical  and  horizontal  angular  movement  of  the  shore  unit 
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necessary  to  align  the  boat  target.  Some  systems  use  the  same  distance¬ 
measuring  method  commonly  used  with  range-range,  whereby  a  shore  transponder 
sends  a  signal  to  a  boat  transponder.  After  a  constant  turnaround  delay,  the 
signal  is  returned  to  the  shore  station  (once  again  two  transponders  at  the 
shore  station  would  help  eliminate  nondirect-path  range  holes).  The  other 
distance-measuring  method  uses  infrared  or  laser  light  as  the  medium  and 
prisms  on  the  boat  as  a  passive  target;  it  uses  either  phase  shift  or  transit 
time  (from  shore  to  boat  and  back)  to  compute  distance.  Angular  movement  of 
the  shore  station  is  normally  measured  by  encoders.  Encoders  may  be  either 
electrical  or  optical  and  measure  degree  of  rotation  from  some  horizontal  and 
vertical  reference.  Normally,  there  is  a  separate  encoder  for  the  vertical 
and  horizontal  angle,  although  some  systems  measure  horizontal  angle  and  use 
relative  distance  and  height  to  approximate  vertical  angle. 

9.  Although  multiple  range-azimuth  sites  could  be  used  in  the  same  way 
that  multiple  range  systems  are  used,  normally  only  one  site  is  used,  as  the 
main  purpose  of  using  this  type  system  is  to  avoid  having  to  establish  more 
than  one  shore  station.  Range-azimuth  positioning  geometry  offers  the  con¬ 
siderable  advantage  over  range-range  geometry  in  that  there  are  no  poor  geom¬ 
etry  areas.  However,  it  has  the  disadvantages  of  being  limited  to  line  of 
sight.  The  small-boat  system  software  supports  range-azimuth  positioning  by 
subtracting  the  reference  angle  and  using  triangulation  to  determine  position. 
Figure  A2  shows  the  method  used  in  a  range-azimuth  positioning  system. 

Absolute  position 

10.  Some  systems  provide  either  absolute  coordinates  or  relative  co¬ 
ordinates.  Satellite  systems,  for  example,  will  provide  absolute  coordinates 
in  some  reference  system  which  will  probably  have  to  be  mapped  onto  the  sur¬ 
veyor's  system.  Some  range-azimuth  systems  supply  relative  coordinates  from 
the  shore  site.  The  software  then  adds  the  relative  coordinate  values  to  the 
absolute  shore  site  coordinates  to  determine  absolute  position. 

Pilot  guidance 

11.  It  is  often  desirable  to  run  predetermined  section  lines.  To  pro¬ 
vide  pilot  guidance,  the  absolute  boat  position  in  easting  and  northing  must 
be  related  to  the  section  line  in  terms  of  distance  along  the  line  and  offset 
from  the  line.  The  method  of  computing  distance  along  the  line  and  offset 
from  the  line  is  shown  in  Figure  A3. 
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1.  Convert  survey  instruments  coordinate  system  to 
that  used  by  the  computer: 

AZMjj  =  90  -  AZM^ 

AZMy  =  90  -  AZMyg 


azmva  =  |az; 


(1) 

(2) 
(3) 


where 


Figure  A2.  Computing  boat  position  given  a  range- 
azimuth  positioning  system  (Sheet  1  of  3) 
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coordinate  system 
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where 

R  -  range 

R„  =  range  horizontal 
Rv  =  range  vertical 


c.  Computing  horizontal  component  of  range 


2.  Determine  vertical  and  horizontal  components  of 
range : 


Rr  =  R  cos  (AZMyA) 

(4) 

Ry  =  R  sin  |AZMyAj 

(5) 

Set  Ry  negative  if  viewing  downward. 

If  AZM^  is  less  than  0,  then 

Rv  = 

(6) 

Adjust  vertical  height  to  remove  effect 

of  boat 

antenna  height  H  from  water: 

D 

Rv  =  Rv  -  hb 

(7) 

4.  Calculate  height  of  boat  with  respect  to  zero 
reference  plane: 


Hr  =  Hx  +  Ry  (8) 

Figure  A2.  (Sheet  2  of  3) 
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u 


where 


Hr  =  height  of  boat  measured  from  reference 
=  height  of  Transponder 

5.  Convert  from  polar  to  rectangular  coordinates  to 
get  boat's  easting  and  northing  relative  to 


transponder : 

Eo  ■  h  c°s  (azmk) 

(9) 

»o  -  “h  sln  (azmh) 

(10) 

Add  relative 

coordinates  to  transponder's 

coordinates , 

E  and  N  ,  to  get  boat's 

position: 

eb  =  Eo  +  et 

(ID 

nb  =  No  +  nt 

(12) 

Figure  A2.  (Sheet  3  of  3) 
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where 


ES,NS  =  easting  and  northing  start  of  line 
EF.NF  =  easting  and  northing  end  of  line 
Nst  =  northerly  distance  from  Ns  to  NF 
EFF  -  easterly  distance  from  Es  to  EF 


Pi  =  F„,NS 
¥/  =  Ef  .  Nf 


a.  Line  to  be  surveyed 


Fiiure  A3.  Converting  boat  position  Eg 


distance  D  along  and  offset  0 
(Sheet  1  of  6) 


from  a  line 


Al  2 


Compute  equation  of  line  to 
(AX  +  BY  +  C  =  0). 

be  surveyed 

a. 

Get  projection  of  line  on  x-  and  y-axis 
(a  signed  length) . 

nes  =  ne  - 

Ns 

(1) 

ees  ee  - 

Es 

(2) 

b. 

Test  projection  of  line  on  x-axis;  if  0, 
/ertical  line  of  infinite  slope. 

then 

c . 

Compute  coefficients  of 

line  using 

A  =  1 

(3) 

CXI 

II 

o 

(4) 

c  =  ~Es 

(5) 

if  eeb  is  0  • 


Or 

nes 

A  «  ~  (6) 

ees 

B  =  -1  (7) 

C  "  Ng  -  AEg  (8) 

if  E  is  not  0  . 

The  formula  of  a  straight  line 


Y  =  mX  +  b  (9) 

where  m  is  the  slope  of  the  line  and  b  is  the 
Y  offset  when  X  =  0  ,  is  used  as  a  basis  to  get 
the  first-degree  equation  form 

AX  +  BY  +  C  =  0  (10) 

where  A  ,  B  ,  and  C  are  coefficients  of  a 
straight  line,  by  simply  rearranging  Equation  9 
to  yield 

mX  -  Y  +  b  =  0  (11) 
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Comparing  Equations  10  and  11  suggests 


A  =  m 

(12) 

B  =  -1 

(7) 

C  =  b 

(13) 

Since  the  slope  of  the  line  is  simply  its 
y-projection  divided  by  its  x-projection, 

nes 

m  = 

ES 

(14) 

and  Equation  12  may  be  rewritten  as 

a.!s 

ees 

(6) 

The  constant  b  may  ba  computed  by  either 

projecting  the  line  back  to  the  point  it  crosses  the 

y-axis  and  reading  the  value  of  y  or  by  "plugging 

in"  a  known  value  of  x  and  y  such  as  (E  ,  N  ) 

b  b 

and  calculating  b  from  Equation  11.  Equation  11 
may  be  combined  with  Equation  12  to  yield 

AX  -  Y  +  b  -  0 

(15) 

Plugging  in  (Eg 

,  Ng)  for  (x,  y)  gives 

or  rearranging 

AES  -  Ss  +  b  -  0 

(16) 

b  -  Ns  -  AES 

(17) 

Combining  Equations  13  and  17  gives 


C  =  Ng  -  AES  (18) 

Therefore,  Equations  6-8  give  the  coefficients  of  the 
straight-line  equation  for  the  general  case.  Equa¬ 
tion  6  goes  to  infinity  for  the  case  when  the  survey 
line  is  vertical  (i.e.,  E^g  *  0)  and  this  special  case 
must  be  tested  for  and  treated  separately. 

If  the  line  is  vertical,  its  general  equation  is 

X  =  a  (19) 
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where  a  is  the  offset  from  the  y-axis.  Rewriting 
Equation  19  in  the  form  of  Equation  10  gives 

X  +  (0  *  Y)  -  a  =  0  (20) 

Comparing  Equations  10  and  20  suggests 

A  =  1  (3) 

B  =  0  (4) 

C  =  -a  (21) 

The  offset  from  the  y-axis  of  the  vertical  line 
is  constant  and  equal  to  the  offset  at  the 
beginning 

a  =  Es  (22) 

or  end 

a  =  E£  (23) 

of  the  line. 

Substituting  Equation  22  into  Equation  21  gives 

C  -  -Eg  (5) 

Therefore,  Equations  3-5  give  the  coefficients  of 
the  straight-line  equation  for  the  special  case. 

2.  Use  the  coefficients  of  the  straight  line  (A,B,C) 
calculated  in  step  1  and  the  boat  coordinates 
(Eg.Ng)  to  calculate  the  distance  off  line  using 
the  trigonometric  equation  for  the  perpendicular 
distance  from  a  point  to  a  line: 

A*E  +B*N  +C 

Offset  =  -  (24) 

End 

i 
i 
i 

b.  Distance  of  boat  off  line  ]  < - AX  +  BY  +  C  =  0 

Eb,Nb  * - 

Offset  | 

i 

i 

i 

i 

Beginning 
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3.  Assign  a  sign  to  the  offset  to  signify  if  the  boat 
is  to  the  left  (-)  or  the  right  (+)  of  the  line 
when  facing  toward  the  end  of  line  while  posi¬ 
tioned  at  beginning  of  line. 

a.  Compute  the  angle  of  the  boat  with  respect  to 
the  x-axis  at  the  beginning  of  line: 


Angle  Boat  Absolute  =  arc  tan 


(25) 


b.  Compute  the  angle  of  the  boat  with  respect  to 
the  survey  line : 

Angle  Boat  Relative  =  Angle  Boat  Absolute  (26) 

-  Angle  Line 

where 


Angle  Line  =  arc  tan 


(27) 


c.  If  the  angle  of  the  boat  relative  to  the  sur¬ 
vey  line  is  between  0  deg  and  180  deg,  the 
boat  is  to  the  left  of  the  line  and 

Offset  *  -Offset’  (28) 

Otherwise,  the  boat  is  to  the  right  of  the 
line  and  the  offset  is  positive. 

4.  Finally,  the  distance  along  the  line  is  cal¬ 
culated  using  the  Pythagorean  theorem. 

a.  Compute  the  distance  from  the  boat  to  the 
beginning  of  the  line: 
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where 

D»  =  Distance  along  line 

D»  =  Distance  from  start  of  line  to  boat 
0  =  Offset  distance  of  boat  from  line 


c.  Boat's  distance  along  the  line 

b.  Compute  the  boat's  distance  along  the  survey 
line: 


da-^(db  -°2)  <3°> 

c.  Assign  a  sign  to  the  distance  along  .line  to 
signify  if  the  boat  has  not  reached  (-)  the 
beginning  of  the  line  or  has  proceeded  past 
the  beginning  of  line  (+) .  If  90°  <  Angle 
Boat  Relative  <  270°  then 


D 


A 


(31) 
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APPENDIX  B:  CIRCUIT  AND  CABLE  DIAGRAMS 


Figure  Bl.  Autotape  cable  (Autotape  is  a  registered  trademark  of 

Cubic  Precision  Corporation) 


12  RED 

2  GREEN 


NORTE 

SERIAL 
/  CONNECTOR 


2  METER  DEL  NORTE  CABLE 


Figure  B3 .  Internal  to  Del  Norte  jumper  J22-39  to  Jl-K  (serial).  (Not 
Fin  J  is  used  instead  oi  K  on  older  boxes.)  (Del  Norte  is  a  registered 

trademark  of  Del  Norte  Technology) 


3 

GREEN 

3 

BLACK 

25  kilo 
<->  oh  MS 


1  micro 
far  ad 


Figure  B4.  Dei  Norte  RS232  to  TTL  Box 


APPENDIX  C:  DETAILED  PROGRAM  DESCRIPTIONS 


This  appendix  presents  flowcharts  and  sample  runs  for  each  of  the  pro- 

grams  along  with  a  description  of 

the  program  and  discussion  of  the  theory. 

The  programs  are  discussed  in  the 

following  order: 

3D_MAKE 

MARKS_TO_DESCRIPTOR* 

3D_PL0T 

MARKS_TO_FEATU  RES* 

ACAD_PLOT 

MARK_DESCRIPTION 

ACAD  XYZ 

MOB ILE_QUANT I TY_FORMAT 

ADJUST  DEPTHS_FOR  TIDE 

MOB I LE_S INGLE_QUANTI TY 

CONFIGURE* 

NEW_LINE_INPUT 

CONTOUR_PLOT* 

NEW_SPOT_INPUT 

CONVERT  DATA* 

PILOT* 

CONVERT JDATA_LOUISVILLE* 

PLAN_VIEW_DESCRIPTION 

CROSS_SECTION_AND_DREDGING 

PLOT_FEATURES 

CROSS_SECTION_DESCRIPTION 

PLOT_LETTERS 

DEPTH  DEVICE* 

PLOT_LETTERS_DESCRIPTION 

D  EPTH_S IMULAT E * 

PLOT_PLOTTER* 

DIGITIZE_DEPTH  CHART 

PLOT_PLOTTER_LOUISVILLE* 

DIGIT IZE_FEATURES 

PLOT_SCREEN* 

DIGITIZE_PLOTTER 

PLOT_SCREEN IMAGE* 

EDIT_DATA 

PLOT_SCREEN_LOUISVILLE* 

EDIT_FEATURES** 

PRINT* 

EQUIPMFNT_ENTRY 

PRINT_DATA 

FIND  SPOT* 

PRINT_MARKS 

GENERIC_TO__GRID_FORMAT* 

RANDOM* 

INDICATOR* 

RANGE_DEVICE* 

INTERSECTION  OF  2  LINES 

RANGE_SIMULATE* 

MANUAL  SURVEY  ENTRY 

SURVEY 

MARKS  HARRIS* 

*  Sample  run  not  included. 
**  Flow  chart  not  included. 
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3D  MAKE 


Purpose 

3D_MAKE  is  a  program  that  transposes  the  acquired  data  onto  a  rectangu¬ 
lar  grid  for  input  to  the  three-dimensional  (3D)  plotting  program. 

Input  files 

NAME. LINE,  NAME. 0001  (where  .0001  is  line  number) 

Output  files 
TEMP3D 

External  devices 
NONE 

Modules  called 

GET_DEPTHS ,  PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK,  DRAWF0RM, 
GET_NAME_OF_FILE 
Theory  of  operation 

The  progam  initializes  variables.  It  then  displays  the  file  form  for 
input  file  (NAME) .  Then  it  reads  in  the  data  and  averages  points  along  the 
line  to  produce  a  point  at  the  desired  grid  interval.  The  section  lines  are 
used  for  the  fixed  grid  intervals  regardless  of  separation  or  azimuth  so  the 
distance  along  channel  of  the  3D  plot  will  not  reflect  actual  distance  along 
channel,  usually.  The  grid  points  are  saved  in  TEMP3D  for  use  by  3D_PL0T. 

The  flowchart  is  shown  in  Figure  Cl,  and  two  sample  runs  are  shown  in 
Figure  C2. 
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3D  PLOT 


Purpose 

3D_PL0T  is  a  program  -hat  plots  data  in  a  rectangular  gridded  format  on 
the  screen,  a  prinfer,  and/or  a  plotter. 

Input  files 
TEMP3D 
Output  files 
NONE 

External  devices 

Printer,  plotter 
Modules  called 

PRO J ,  SCREEN_LINE  PLOT,  POINT_ALONG_A_LINE ,  PLOT_SCR,  LTS , 
SCALE_IT_SCREEN,  A2,  PR1NT_SCREEN ,  PROBLEM,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM, 
INITMENU. 

Theory  of  operation 

The  program  initializes  variables.  It  then  displays  a  file  form  to  ac¬ 
cept  vertical  tilt  angle,  horizontal  rotation,  output  devices,  display  of 
sider  enabled,  and  plot  size.  The  data  are  then  smoothed  by  a  nonrecursive 
filter  and  scales.  Plotting  is  done  by  the  subroutine  PROJ. 
shown  in  Figure  C3,  and  a  sample  run  is  shown  in  Figure  C4. 


The  flowchart  is 


ACAD  PLOT 


Purpose 

ACAD_PLOT  is  a  program  that  plots  DXF  plot  files. 
Input  files 

NAME  (entered  from  keyboard) 

Output  files 
NONE 


External  devices 
Plotter 

Modules  called 
NONE 


Theory  of  operation 

The  program  accepts  the  input  file  name  and  scaling  factor.  It  reads 
data  from  the  input  file,  scales  it,  and  plots  it.  The  flowchart  is  shown  in 
Figure  C5,  and  a  sample  run  is  shown  in  Figure  C6. 


^ACaC  PLOT "PUN' 

ENTER  FILE  NAME 

ENTER  PEN  HO 

ENTER  X  SCALE  FhCTOP  IN  FT  IN  •  y  FUR  hUTO 

0 

ENTER  V  SCALE  FhCTOP  IN  FT  IN  •' 0  FOR  AUTO 

0 


ACAD  PLOT- I 


figure  C5.  Flowcharts, 
ACAD  PLOT 


Figure  C6.  Sample  run,  ACAD  PLOT 


ACAD  XYZ 


Purpose 

ACAD_XYZ  is  «  program  to  read  in  the  acquired  data  from  a  site,  reduce 
the  number  of  points  to  500  or  less  by  averaging,  and  write  a  DXF  file  of  the 
points . 

Input  files 

NAME. 0001  (where  .0001  is  the  line  number) 

Output  files 
XYZ 

External  devices 
NONE 

Modules  called 

INITMENU,  DRAWFORM,  GET_NAME_OF_FILE ,  POLREC,  A2 ,  PROBLEM 
Theory  of  operation 

The  program  begins  by  displaying  a  file  form  for  entry  of  the  input 
file.  It  then  reads  in  the  .LINE  file  and  determines  the  number  of  equally 
spaced  points  to  extract  from  each  line  (500/number  of  lines).  The  program 
reads  in  the  lines  and  averages  the  points  for  output  in  XYZ  format.  The 
flowchart  is  shown  in  Figure  C7,  and  a  sample  run  is  shown  in  Figure  C8. 
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Figure  C7.  Flowchart, 
ACAD  XYZ 
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Figure  C8.  Sample  run,  ACAD  XYZ 


CIO 


ADJUST_DEPTHS_FOR_TII  E 

Purpose 

ADJUST_DEPTHS_FOR_TIDE  is  a  program  that  removes  tidal  trends  from  data 
to  reference  it  to  a  fixed  elevation  (such  as  mean  sea  level  or  mean  lower  low 
water).  It  accepts  tide  values  based  on  time  of  day  and  removes  the  tide 
value  corresponding  to  the  particular  data  value's  time  of  acquisition. 

Input  files 

NAME. 0001  (where  .0001  is  line  number) 

Output  files 

NAME. 0001  (where  .0001  is  line  number) 

External  devices 
NONE 

Modules  called 

PROBLEM,  GET_NAME_OF_FILE,  INITMENU,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM 
Theory  of  operation 

The  program  begins  by  initializing  pointers.  It  then  displays  the  data 
file  input  form  by  calling  DRAWFORM  with  a  first  argument  of  INFCOMMANDSTR. 
Then  it  asks  which  of  the  three  tide  input  methods  to  use:  (1)  fixed  tide, 

(2)  step  tide,  or  (3)  linearly  interpolated  tide.  This  is  done  by  calling 
DRAWMENU  with  METHOD  returned  as  1,  2,  or  3.  Then  a  tide  entry  form  is  pro¬ 
duced,  if  the  method  was  1,  by  calling  DRAWFORM  with  the  first  argument 
MADCOMMANDSTR.  If  the  method  was  2  or  3,  a  series  of  tide  versus  time  input 
forms  are  produced  by  calls  to  DRAWFORM  with  the  first  argument  of 
ADCOMMaNDSTR .  The  tide  values  are  stored  in  READING  and  the  tides  in 
TLMETIDE.  The  flowchart  is  shown  in  Figure  C9,  and  a  sample  run  is  shown  in 
Figure  CIO. 
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Figure  C9 .  Flowchart, 
ADJUST  DEPTHS  FOR  TIDE 


Figure  CIO.  Sample  run, 
ADJUST  DEPTHS  FOR  TIDE 


CONFIGURE 


Purpose 

CONFIGURE  is  a  program  that  configures  the  surveying  multiprogram  opera¬ 
tion.  It  reads  in  site  information  from  disk  file  and  displays  forms  for  in¬ 
put  of  test  specific  information. 

Input  files 

NAME. LINE,  NAME.EQUI,  DEFAULT,  DEFAULT . EQUI ,  NAME. SPOT,  NAME. PLAN, 
DEFAULT. PLAN,  BAR_ID.LIST 
Output  files 

DEFAULT,  DEFAULT. EQUI 
External  devices 

NONE 

Modules  called 

LOUISVILLE_STYLE_SURVEY,  FIND_SPOT__SURVEY ,  SECTION_LINE_SURVEY , 
WORKING_CODE_SL,  POLREC,  A2,  PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK, 
DRAWFORM,  GET_NAME_OF_FILE ,  GET_BAR_ID 
Theory  of  operation 

CONFIGURE  is  not  a  stand-alone  program.  It  is  a  task  which  is  spawned 
by  SURVEY.  Its  purpose  is  to  come  into  memory  before  any  of  the  real-time 
survey  programs  are  spawned,  accept  test  parameters,  then  die,  thereby  freeing 
memory.  It  first  displays  the  survey  type  hardware  configuration  menu.  It 
then  reads  in  section  lines,  channel  coordinates,  plotter  type,  etc.  Depend¬ 
ing  on  the  type  of  survey,  it  displays  applicable  forms.  All  data  input  is 
stored  in  a  common  block  of  memory,  and  the  program  dies,  freeing  memorv.  The 
flowchart  is  shown  in  Figure  CI1. 
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Figure  Cil.  Flowchart 
CONFIGURE  (Continued) 
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Figure  Cll.  (Concluded) 


CONTOUR  Plot 


Purpose 

CONTOUR_PLOT  runs  after  PLAN_VIEW  to  lay  contours  on  top  of  the  plan 

view. 

Input  files 

TEMPCONTOQR,  POSI 
Output  files 

tempi,  temp2 
External  devices 
Plotter 

Modules  called 

IND,  COEF ,  LTEST,  STEST,  CONPLT,  FLIN,  CONZL,  DERIV,  POLY,  REFHUL, 
READIN,  GETXYZ ,  MINMAX,  SHELL,  PUTXYZ,  TMESH2 ,  TMESH3 ,  PLYTR2 ,  TRIANG,  CONHUL, 
PLOTSC,  PLOTROT,  TRANSPOSE_ORIGIN,  SYMBOL  ROTSC,  SYMBOLROT,  PA,  PR,  IN,  READ I I 
Theory  of  operation 

The  program  begins  by  reading  in  the  rotation,  scaling,  and  alignment 
information  from  TEMPCONTOUR.  Then  the  number  of  contour  levels  and  beginning 
and  ending  levels  are  read  in.  Next  the  present  paper  origin  from  PLAN_VIEW 
is  read  in  (from  file  POSI).  Then  data  are  read  in,  contoured,  and  plotted. 
Tempi  and  temp2  are  used  for  temporary  storage  of  partial  derivatives  (Z  with 
respect  to  X,  Y,  XX  yy ,  and  XY)  and  of  data.  The  plot  is  anotated  with  a,  b, 
c...to  delineate  trie  contours.  The  flowchart  is  shown  in  Figure  Cl 2. 
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Figure  C12.  Flowchart, 
CONTOUR  PLOT 


CONVERT  DATA 


Purpose 

CONVERT_DATA  takes  acquired  depth  data  from  Grid*  internal  format  and 
converts  it  to  an  ASCII  distance  along  the  line  versus  depth  format.  The  file 
created  conforms  to  the  requirements  for  input  to  a  Harris**  program. 

Input  files 

NAME. LINE,  NAME. 0001  (where  .0001  is  the  line  number) 

Output  files 

NAME . HARR 
External  devices 
NONE 

Modules  called 

POLREC,  PROBLEM..  INITMENU ,  DRAWMENU,  MESSAGESTACK,  DRAWFORM, 
GET_NAME_OF_FILE 
Theory  of  operation 

C.0NVERT_DATA  begins  by  displaying  a  file  form  and  accepting  the  input 
file  name.  It  then  accepts  a  number  of  Harris  specific  values  from  key: 

(1)  three  lines  of  header,  (2)  elevation,  (3)  horizontal  scale,  and  (4)  verti¬ 
cal  scale.  It  then  reads  in  the  data,  converts  it  to  distance  along  the  line 
versus  depth,  and  writes  it  out  to  the  output  file,  NAME. HARR.  The  flowchart 
is  shown  in  Figure  C13. 


'-rid.  is  a  registered  trademark  of  Grid  Systems  Corporation. 
**  Harris  is  a  registered  trademark  of  the  Harris  Corporation. 


ACCEPT  HARRIS  PROCRAM  SPECIFIC 
1HFORMAT ION  FROM  KEY 


Figure  Cl 3.  Flowchart, 
CONVERT  DATA 


CONVERT  DATA  LOUISVILLE 


Purpose 

CONVERT_DATA_LOUISVILLE  converts  depth  data  from  Grid  internal  format  to 
easting-northing-depth  format  for  input  to  a  Harris  program. 

Input  files 

NAME.EQUI,  NAME. 0001  (where  .0001  is  the  line  number) 

Output  files 

NAME .  KARR 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU ,  DRAWMENU,  MESSAGESTACK,  DRAWFORM,  GET_NAME_OF_FILE 
Theory  of  operation 

C  n  ftfV  E  R  T_p A  T  A_  L  0  V I S Y I L L ”  first  displays  a  file  fonn  and  accepts  an  inpot 
file  name.  It  then  reads  in  the  .EQUI  file  to  get  the  transponder  coordi¬ 
nates.  Next  it  reads  in  the  data  lines  and  converts  the  data  to  easting¬ 
northing-depth  format.  A  file  compatible  with  a  Harris  program  is  output. 

The  flowchart  is  shown  in  Figure  C14. 
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Figure  C14.  Flowchart, 
CONVERT  DATA  LOUISVILLE 


CROSS  SECTION  AND  DREDGING 


Purpose 

CROSS_SECTION_AND_DREDGING  displays  cross  sections  and  plots  them  for 
pre-  and  postdredge  surveys.  It  computes  areas  and  volumes  for  each  survey 
with  respect  to  the  channel  template  and  with  respect  to  each  other. 

Input  files 

DEFAULT. OPT I,  NAME. OPT I ,  NAME . CROS ,  NAME. 0001  (where  .0001  is  line 
number) 

Output  files 

QUANTITIES 
External  devices 

Printer,  plotter 
Modules  called 

BETW,  QUANTITIES,  QUANPRNT,  ADVANCEPLOT,  ENOUGHDATA,  PAGE, 
SL_SLIDE_SLOPE_EQUATION,  LAW_0F_COSINES ,  GET_DEPTHS ,  DEPTHSCREEN, 

TEMPLATE^ SCREEN,  LTS ,  CHARFEET,  SCREENLINE,  RDRAW,  LTS ,  DW,  SCALE_IT_SCREEN , 
P0LREC,  SCALE_IT_PLOT,  A2,  EQUATI0N_FR0M_SL0PE_AND_1_P0INT , 
EQUATION_PERPENDICULAR_TO_LINE,  SCR£EN_LINE_PLOT ,  EQUATI0N_FR0M_2_P0INTS , 
INTERSECTION,  P0IN1_AL0NG_A_LINE,  PROBLEM,  INITMF.NU,  DRAWMENU,  MESSAGESTACK, 
DRAWFORM,  GET_NAME_OF_FILE ,  PRINT_SCREEN 
Theory  of  operation 

The  program  reads  in  the  .LINE  file,  then  begins  a  hierarchical  search 
for  an  addition  option  file.  It  looks  for  NAME. OPT I;  if  this  fails  it  looks 
for  DEFAULT. OPTI .  If  neither  exists,  it  uses  predefined  options  for  stacking 
top  to  bottom  or  bottom  to  top  and  predefined  axis  labels.  It  then  reads  In 
the  .CROS  file  and  begins  reading  in  the  data  lines  sequentially  from  the 
first  requested  to  the  last  requested.  Templates  and  blov.  r !  'e  are  computed. 
Templates  are  displayed/plotted  by  calling  TEMPLATE_SCREEN;  ~upths  are 
displayed/plotted  by  calling  DEPTHSCREEN.  Quantities  are  computed  via 
QUANTITIES.  Quantities  are  printed  and  written  to  a  disk  file  (Quantities) 
for  subsequent  processing  by  calling  QUANPRNT.  The  flowchart  is  shown  in 
Fiftu.'t  r,c'  and  a  sample  run  is  shown  in  Figure  C16. 
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Figure  C15.  Flowchart, 
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CROSS  SECTION  DESCRIPTION 


Purpose 

CROSS_SECTION_DESCRIPTION  provides  a  friendly  environment  for  entering 
information  necessary  for  creating  cross  section  plots. 

Input  files 

NAME . CROS 
Output  files 

NAME. CROS 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  GET_NAME_OF_FILE 
Theory  of  operation 

CR0SS_SECTI0N_DESCR1PTI0N  reads  in  current  plot  parameters,  fills  a  form 
with  these  values,  and  displays  the  form.  It  then  accepts  changes  and  outputs 
a  .CROS  file.  A  flowchart  is  shown  in  Figure  Cl 7,  and  a  sample  run  is  shown 
in  Figure  C18. 
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display  file  form 


open  CROS  FILE  AND 
READ  CURRENT  UALUES 


DISPLAY  TEMPLATE  FORM 


DISPLAY  ALLOWED  SIDE 
SLOPE  FORM 


DISPLAY  CENTER  LINE  FORM 


Figure  C17.  Flowchart, 
CROSS  SECTION  DESCRIPTION 
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Figure  C18.  Sample  run, 
CROSS_SECTION_DESCRIPTION 
(Continued) 
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ENTER  INFORMATION  hBOUT  PREOPEOGE  DEPTH  i?.  CONFIRM 
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Figure  C18.  (Concluded) 
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DEPTH  DEVICE 


Purpose 

There  a  number  of  depth  equipment  programs  and  one  simulation  pro¬ 

gram.  r'",r'  of  these  programs  runs  in  conjunction  with  the  survey  program, 
determined  by  the  depth  sounder  used.  These  programs  collect  depths,  generate 
event  marks  on  chart  paper,  and  save  all  desired  data. 

Input  files 

NONE  (data  are  passed  through  a  common  block  of  memory) 

Output  files 

NONE  (data  are  passed  through  a  common  block  of  memory) 

Equipment  required 

Supported  depth  sounder  with  IEEE488  interface  (Institute  of  Electrical 
and  Electronics  (IEEE)  Standards  Board  1978)* 

Modules  called 

TIME_INTO_TEST,  RAYTHEON,  INNERSPACE . 001  (depth  sounder  specific), 
INITDR,  READDR,  WRITEDR,  TERM,  PROBLEM 
Theory  of  operation 

The  depth  equipment  program  is  spawned  by  SURVEY,  does  some  initializa¬ 
tion,  and  waits  for  PLOT_SCREEN  to  set  a  flag  before  proceeding  (PLOT_SCREEN 
is  the  last  task  spawned  so  all  are  memory  resident  at  this  time).  It  then 
begins  a  tight  loop  of  generating  chart  event  marks,  acquiring  depths,  and 
putting  acquired  data  in  the  output  buffer.  It  terminates  when  PLOT_SCREEN 
sets  the  death  flag.  Flowcharts  are  shown  in  Figure  C19. 


*  All  references  cited  in  this  Appendix  are  included  in  the  References  at  the 
end  of  the  main  text. 
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C19 .  (Sheet  2  of  5) 


Figure  C19.  (Sheet  3  of  5) 


Figure  CI9.  (Sheet  4  of  5) 
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DEPTH  SIMULATE 


Purpose 

DEPTH_SIMULATE  is  a  task  in  the  survey  package  spawned  by  the  task 
SURVEY.  It  is  used  to  provide  simulated  depth  data  when  a  depth  sounder  is 
not  attached. 

Input  files 

NONE  (data  are  passed  through  system  common  memory) 

Output  files 

NONE  (data  are  passed  through  system  common  memory) 

External  devices 

NONE 

Modules  called 

TIME_INTO_TEST ,  PROBLEM 
Theory  of  operation 

DEPTH_SIMULATE  initializes  parameters  then  waits  for  PLOT_SCREEN  to  set 
a  flag  indicating  all  tasks  are  running.  It  then  begins  a  loop  generating  a 
point  approximately  every  0.1  sec.  The  program  saves  any  tides  that  have 
become  available  in  the  common  buffer.  It  then  checks  to  see  if  it  is  time  to 
save  a  depth  based  on  time  interval,  distance  along  tne  line  interval,  or 
change  in  depth  since  last  reading.  After  saving  any  depths,  it  tests  to  see 
If  any  marks  have  become  available  and  saves  them.  It  then  reloops.  The 
flowchart  is  shown  in  Figure  C20. 
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Figure  C20.  Flowchart, 
DEPTH  SIMULATE  (Sheet  1 
of  3) 


Figure  C20.  (Sheet  3  of  3) 
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DIGITIZE  DEPTH  CHART 


Purpose 

To  acquire  data  from  a  depth  chart  using  a  digitizing  tablet.  Since  the 
boat  may  be  moving  at  a  nonconstant  velocity  during  the  line,  there  is  a  mode 
by  which  nonlinear  x-axis  data  may  be  entered. 

Input  files 

NAME. LINE 
Output  files 

NAME. 0001 
External  devices 

Summagraphics  Bit  Pad  1  or  Microgrid  pencil  digitizer* 

Modules  called 

PROBLEM,  POLREC,  A2 ,  INITMENU,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM, 

DISTOFF,  GET_NAME_OF_FILE,  DIGITIZER,  INISER,  RDSERI ,  WRSERT ,  TERMSE ,  ROTATE, 
INI  SOUND,  WRSOUND,  TERMSD 
Theory  of  operation 

DIGITIZE_DEPTH_CHART  reads  in  the  .LINE  file.  It  then  has  the  operator 
calibrate  the  chart  in  digitizer  units.  It  then  asks  which  paper  direction 
corresponds  to  the  left  side  of  the  channel,  by  looking  at  the  section  line 
file  to  get  the  direction,  then  asking  if  this  is  correct  or  reversed.  If  it 
is  reversed,  it  exchanges  the  start  and  stop  of  line  coordinates  and  sets  the 
correction  flag.  Then  it  accepts  data  from  the  digitizer  until  the  end  of 
line  is  passed  or  the  /  is  pressed.  The  flowchart  is  shown  in  Figure  C21,  and 
a  sample  run  is  shown  in  Figure  C22. 


*  Bit  Pad  1  and  Microgrid  are  trade  names  of  the  Summagraphics  Corporation. 
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D IG I T I ZE_DEPTH_CHART- 1 
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Figure  C 22.  Sample  run, 
D IG I T I Z E_DEPTH_CHART 
(Continued) 
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Figure  C22.  (Concluded) 
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DIGITIZE  FEATURES 


Purpose 

DIGITIZE  FEATURES  is  used  to  enter  coordinate  information  from  maps  into 
•FEAT  files  on  the  computer.  Shorelines  and  special  features  are  digitized 
for  later  plotting  with  data. 

Input  files 

NONE 

Output  files 

NAME. FEAT,  NAME. LABE 
External  devices 

Summagraphics  Bit  Pad  1  or  Microgrid  digitizer 
Modules  called 

PROBLEM,  POLREC,  A2 ,  INITMENU,  DRAWMENU,  MESSAGESTACK,  DRAWFORM, 

DISTOFF,  GET_NAME_OF_FILE,  ROTATE,  DIGITIZER,  DIGITIZER2 ,  INISOUND,  WRSOCND, 
TERMSO ,  INISER,  RDSERI ,  WRSERI,  TERMSE 
Theory  of  operation 

D I G I T I Z E_FEATURE S  begins  by  accepting  the  output  file  name  and  type  of 
digitizer.  It  then  calibrates  the  map  to  digitizer  units.  At  this  point  a 
loop  begins  where  the  user  specifies  whether  the  next  action  will  be  to  enter 
a  feature  or  a  label.  Features  are  saved  in  the  .FEAT  file.  Labels  are  saved 
in  the  .LABE  file.  A  flowchart  is  shown  in  Figure  C23,  and  a  sample  run  is 
shown  in  Figure  C24. 
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0 1 6 1 T I ZE_FEATURES-  1 


b'UTEC  F.mSTInG  in  FEET  FOR  riK-xT  POINT 

750000 

LUTE**'  NifR^-'  r.  •'  F_Z T  *  _-n.  r  IK*  I  roihi 

\  UUOOUU 
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R 
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ENTER  PEN  NUMBER  FOR  L  hBEL  ■  1-8  • 

ENTER  TEST  FOR  LHBEL 

MOBILE  FHNhMh  CITY  SURVEYORS  DO  IT  WITH  f 

47 

MOBILE  PhNhiIh  u  |j  Sor^'t i UPS  uv  IT  WIT.' I  ? 
PRESS  PEN  DOWN  TO  DIGITIZE  SThPT  POINT  OF 
756570  75  1160110  75 

PRESS  PEN  DOWN  TO  DIGITIZE  FINISH  POINT  OF 
76 7947  5 6  1 6 9 0 0 6 0  5 0 

ENTER  PEN  NUMBER  THIS  FFhTiJF'E  ■  0-8  • 

OR  9  TO  LhBEL  m  FEhTUF'E 
OF  -1  TO  OUIT 


DIGITIZE_FEATURES-4 


DIGITIZE  FEATURES-: 


HI  IHt  :HI'lt  NUK.HIMG  Hv  Iht  HKil  KUiNI 
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760OOO 

PRESS  PEN  DOWN  TO  DIGITISE  SECOND  POINT 

2428  00  'CIS  00 

THIF'D  POINT  SHOULD  PE  IN  THE  UPPER  FIGHT  HhND  CORNER 
hT  THE  ShmE  Eh'STING  hS  THE  SECOND  POINT 
ENTEP  HOPTHING  IN  FEET  FOP  THIF'D  POINT 

1 J 000 00 

PRESS  PEN  DOWN  TO  DIGITIZE  THIRD  POINT 

2482  OO  2772  0O 

EPP'OP  FROM  00  GEGP'EE  HNGLE  IS  0  1 
ENTER  PEN  NUMBER  THIS.  FEhTUPE  .  0-8' 

OP  2  TO  LhBEL  h  FEhTUPE 
OP  -  1  TO  DU  I T 
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Figure  C2A.  Sample  run 
DIGITIZE  FEATURES 


DIGITIZE  PLOTTER 


Purpose 

DIGITIZE_PLOTTER  is  a  program  that  digitizes  features  from  the  plotter 
using  a  digitizing  sight  instead  of  a  pen.  It  is  a  much  slower  method  than 
using  the  digitizing  tablet  with  DIGITIZE_FEATURES  and  should  be  used  only  if 
a  digitizing  tablet  is  not  available.  The  digitizing  sight  is  moved  to  a 
point  on  the  plot  and  the  space  bar  is  pressed  to  acquire  the  point. 

Incut  files 
NONE 

Output  files 

NAME. FEAT 
External  devices 

Hewlett-Packard  Company  plotter  with  IEEE488  interface 
Modules  called 

PROBLEM,  POLREC,  A2 ,  INITMENU ,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM, 

DISTOFF,  GET_NAME_OF_FILE,  ROTATE,  DIGITIZER 
Theory  of  operation 

The  program  displays  a  file  form  for  output  file  name.  Then  it  cali¬ 
brates  the  map  in  plotter  units.  Next  it  asks  pen  number,  line  type,  and  dash 
length  for  the  feature.  Finally  it  accepts  points  every  time  the  space  bar  is 
pressed  until  E  or  Q  is  pressed.  E  ends  this  feature,  Q  ends  this  program. 
Special  considerations 

This  program  does  not  allow  inputting  labels  as  DIGITIZE_FEATURES  does. 
Labels  could  easily  be  added  if  needed.  Figure  C25  shows  the  flowchart,  and 
Figure  C26  shows  a  sample  run. 
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DISPLAY  PILE  PORN 


CALIBRATE  HAP 
IN  PLOTTER  UNITS 


ACCEPT  PEN  NUMBER ,  LINE 
TYPE,  AND  DASH  LENGTH 


SPACE  BAR" 


ACCEPT  POINT 
FROM  PLOTTER 


KEY 

PRESSED? 


Figure  C25.  Flowchart, 
DIGITIZE  PLOTTER 
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11  -TEXT  STRING 

FINISHED 

[file  HhME 

ENTER  INPUT  FILE  NAME  hND  CONFIRM 

DIGITIZE_PLQTTER-1 


FIRST  POINT  SHOULD  EE  IN  THE  LOWER  LEFT  HAND  CORNER 


ENTER  EhSTING  IN  FEET  FOR  FIRST  POINT 

85OOO0 

ENTER  NORTHING  IN  FEET  FOR  FIRST  POINT 
1 2OOO00 

PRESS  SPhCE  E'hR  TO  DIGITIZE  FIRST  POINT 
21  05  9  02 

SECOND  POINT  SHOULD  BE  IN  THE  LOWER  RIGHT  HHHD  CORNE 
F 

AT  THE  SAME  NORTHING  AS  THE  FIRST  POINT 

ENTER  EASTING  IN  FEET  FOR  SECOND  POINT 
SE0000 

PRESS  SPACE  BAR  TO  DIGITIZE  SECOND  POINT 


DI6ITIZE_PL0TTER-2 


21  05  y  02 

SECOND  POINT  SHOULD  BE  IN  THE  LOWER  RIGHT  HAND  CORNE 
R 

AT  THE  SAME  NORTHING  hS  THE  FIRST  POINT 

ENTER  EASTING  IN  FEET  FOP  SECOND  POINT 
660000 

PRESS  SPACE  BAR  TO  DIGITIZE  SECOND  POINT 
15  69  8  99 

THIRD  POINT  SHOULD  BE  IN  THE  UPPER  RIGHT  HAND  CORNER 

hT  THE  SAME  EASTING  hS  THE  SECOND  POINT 

ENTER  NORTHING  IN  FEET  FOR  THIRD  POINT 
1 400000 

PRESS  SPACE  BmF:  TO  DIGITIZE  THIRD  POINT 
15  69  13  65 

ERROR  FROM  90  DEGREE  ANGLE  IS  -180  3 

THE  THREE  DIGITIZED  POINTS  DO  NOT  FORM  H  90  DEGREE  A 

NGLE 

REDIGITIZE  THE  THREE  POINTS  IN  ORDER  NOW 


D I G I  T I ZE_PLOT  TER -3 

Figure  C26.  Sample  run,  DIG1TIZE_PL0TTER 
(Continued) 
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HI  IHt  ShNE  LHb  I  i  NG  Hi-  Iht  StUJNU  HIJiNI 

ENTER  NORTHING  IN  FEET  FOR  THIRD  POINT 
1 400000 

FREE.?.  SF'hCE  BhR  TO  DIGITIZE  THIRD  POINT 
1 5  t'9  ]  3  H=i 

EF-PCIR  FROM  90  DEGREE  hHGLE  IS  -ISO  3 
THE  THREE  DIGITIZED  POINTS  DO  NOT  FORM  H  90  DEGREE  h 

N!jlE 

REDIGITIZE  THE  THREE  POINTS  IN  ORDER  NOW 
19  16  9  24 

1520  j  24 

15  20  i  53 

EPPOP  FROM  90  DEGREE  hNGLE  IS  O  O 


BEGIN  DIGITIZING  FEhTURE  NUMBER  1 
ENTER  SPREE  TO  SHMPLE  FLOTTEP  POSITION 
ENTER  E  TO  END  FEHTURE 
ENTER  0  TO  QUIT  WHEN  FINISHED 

ENTER  PEN  NUMBER  THIS  FEhTURE  ■  0-3  . 


DIGITIZE  PLOTTER-4 


Figure  C26.  (Concluded) 
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EDIT  DATA 


Purpose 

EDIT__DATA  allows  data  acquired  by  survey  programs  or  other  means  to  be 
graphically  edited.  Points  may  be  deleted  from  the  existing  curve  or  added 
beyond  the  ends  (overbank) .  The  program  also  automatically  removes  data 
before  the  start  of  line  and  removes  any  duplicate  times  (i.e.,  the  time  of 
data  is  resolved  to  the  nearest  0.1  sec  and  it  is  possible  for  two  depths  to 
be  time  marked  the  same  as  for  fast  digitizers) .  It  is  primarily  used  to 
remove  irregularities  that  get  through  the  digitizer's  wild  point  filter 
(gated  mode),  such  as  schools  of  fish. 

Input  files 

NAME. LINE,  NAME. 0001  (last  four  digits  are  line  number) 

Output  files 

NAME. 0001  (last  four  digits  are  line  number) 

External  devices 

NONE 

Modules  called 

SL_SLIDE_SLOPE_EQUATION,  LAW_0F_C0SINES ,  SAVEPRESENT,  SCREENSAVE, 
SCREENRESTORE,  GET_DEPTHS,  DEPTHSCREEN,  TEMPLATE_SCREEN,  LTS,  CHARFEET, 
SCREENLINE,  DW,  RDRAW,  SCALE_IT_SCREEN,  UNSCALE_IT_PIXEL,  SCALE_IT_PLOT , 
POLREC,  A2,  EQUATI0N_FR0M_SL0PE_AND_1_P0INT,  EQUATION_PERPENDICULAR_TO_LINE , 
SCREEN_LINE_PLOT,  EQUATI0N_FR0M_2_P0INTS ,  INTERSECTION,  POINT_ALONG_A_LINE , 
INITMENU,  DRAWMENU,  MESSAGESTACK,  DRAWFORM,  POINT_ALONG_A_LINE, 
GET_NAME_OF_FILE,  DIST0FF,  WIND RAWLINE  (Grid  Routine) 

Theory  of  operation 

The  program  begins  by  displaying  (via  a  standard  FORTRAN  write  to 
device  6 — the  screen)  a  list  of  potential  command  keys  that  may  be  used  when¬ 
ever  data  is  graphically  displayed:  A  to  add  a  point,  D  to  delete  a  point,  N 
to  advance  to  the  next  line  number,  L  to  select  any  line  number,  ESC  to  exit 
the  program,  and  the  number  and  arrow  key  meanings.  The  arrow  keys  are  used 
to  move  the  crosshair  left,  right,  up,  and  down.  The  number  keys  are  used  to 
preset  the  jump  increment  moved  when  an  arrow  key  is  struck.  The  jump  size 
formula  is  2  (key  value  3)  ,  where  key  value  is  the  number  printed  on  the  key 
(except  that  the  0  key  has  a  value  of  10).  For  example,  when  beyond  the  sides 
of  the  existing  data,  key  value  1  causes  quarter-pixel  jumps  and  key  value 
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8  causes  32  pixel  jumps.  As  the  crosshair  is  moved  about,  the  present  depth 
and  distance  along  the  line  are  numerically  displayed;  therefore,  values  of 
depth  and  distance  along  the  line  may  be  entered  to  quarter-pixel  length  re¬ 
solution  (typically  0.06-ft  depth  and  1.0-ft  distance  along  the  line). 

After  the  key  operations  are  displayed,  a  form  for  entering  the  site 
name  is  displayed  by  a  call  to  DRAWFORM  with  a  first  argument  of 
INFCOMMANDSTR.  Whether  or  not  a  template  is  to  be  used  is  also  entered  into 
this  form.  The  NAME. LINE  file  (where  NAME  is  the  site  name  that  was  entered) 
-ls  then  opened  as  device  3  and  read. 

The  line  number  is  set  to  1  and  the  first  line  is  graphically  displayed. 
If  template  was  selected  (i.e.  ITEMPLATE  equals  1)  then  calls  to 
EQUATION_FROM  2_P0INTS  and  INTERSECTION  are  made  to  determine  how  channel 
easting,  northing  coordinates  relate  to  distance  along  the  section  line. 

Next,  the  data  file  is  opened  (NAME. 0001)  and  read.  The  screen  is  then  scaled 
based  on  the  template  and  data;  and  if  ITEMPLATE  equals  1,  the  intersection  of 
the  template  and  the  sides  of  the  screen  are  computed.  Then  the  template  and 
data  are  displayed.  Next,  the  current  value  of  depth  and  distance  along  line 
are  numerically  displayed  and  a  crosshair  is  drawn  at  this  position  (by  calls 
to  WINDRAWLINE) .  Then  the  program  waits  for  a  key  to  be  depressed.  Execution 
then  branches  to  the  proper  code  to  handle  the  key  value. 

If  a  numeric  key  is  depressed,  IJUMP  is  set  to  that  key's  value.  If  ESC 
is  pressed,  the  program  ends.  If  N  or  L  is  depressed,  the  value  of 
LINE_NUMBER  is  updated  and  the  new  line  is  displayed.  If  A,  D,  or  an  arrow 
key  is  depressed,  the  current  mode  off  operation  (1)  on  the  data  curve  (ION- 
CURVE  equals  1)  or  (2)  beyond  the  ends  of  the  data  curve  (IONCURVE  equals  2) 
is  considered  when  determining  the  statement  number  to  which  to  branch.  Up 
and  down  arrows  and  the  A  key  have  meaning  only  when  beyond  the  curve. 

If  a  point  is  to  be  added  (A),  the  direction  the  line  was  run  (1)  left 
to  right  (IC0RREC1  equals  0)  or  (2)  right  to  left  (ICORRECT  equals  1)  is  con¬ 
sidered  and  the  prei ent  crosshair  position  is  added  to  the  original  data. 

This  involves  converting  the  current  pixel  location  to  depth  versus  distance 
along  the  line,  then  assigning  time  to  the  depth  based  on  corresponding  dis¬ 
tance  along  the  line  and  computing  easting  and  northing  corresponding  to  the 
distance  along  the  line.  The  point  must  be  included  by  moving  existing  points 
one  position  after  the  time  of  interest. 

The  procedure  for  deleting  a  point  is  similar  to  that  of  adding,  in  that 
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direction  run  must  be  considered.  Otherwise  it  is  simpler  in  that  a  point 
need  only  be  removed  from  a  buffer  and  the  graph  replotted. 

Cursor  keys  add  the  jump  index  value  either  to  the  pixel  position  or  to 
the  buffer  index.  The  data  are  quickly  restored  from  a  saved  screen  and  the 
crosshairs  are  superimposed. 

Edited  screens  may  be  saved  or  changes  may  be  discarded.  Whenever  L, 

.V,  or  ESC  is  pressed,  disposition  of  the  current  screen  is  requested. 

Special  Considerations 

If  the  profile  lines  are  among  those  being  edited,  the  template  should 
not  be  displayed.  Since  the  lines  run  parallel  to  the  sides  of  the  channel, 
they  will  not  intersect  the  sides  and  forming  a  template  will  be  impossible 
(an  attempt  to  do  so  under  these  circumstances  may  crash  the  system). 

Edited  files  can  be  distinguished  from  raw  data  files  by  printing  their 
contents.  Originally  depths  and  positions  are  interlaced  (raw  data).  The 
edit  program  groups  all  the  depths  together  and  all  the  ranges  together.  All 
programs  will  work  with  either  layout  as  time  (not  order)  is  used  to  relate 
depths  to  positions. 

It  is  generally  best  to  do  any  editing  desired  prior  to  running  other 
postsurvey  programs.  This  ensures  that  any  bad  data  points  a”e  removed  prior 
to  analysis  and  plotting.  The  flowchart  is  shown  in  Figure  C27,  and  a  sample 
run  is  shown  in  Figure  C28. 
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Figure  C27.  (Sheet  3  of  6) 


Figure  C27.  (Sheet  4  of  6) 


Figure  C27.  (Sheet  5  of  6) 


E  COMMAND  ('EY?  WHEN  DATA  IS  GRAPHICALLY  DISPLAYED 

hOO  h  POINT  WHEN  TO  LEFT  OR:  RIGHT  OF  DhTA 
DELETE  H  POINT  WHEN  ON  DATA 
BRING  UP  NEXT  SEQUENTIAL  LINE 
BRING  IJP  A  SEuECTED  LINE 

NUMBERED  KEYS  SET  ARROW  KEY  JUMP  SIZE  2MKEY 
ARROW  KEY  HONE  LEFT  SELF'~TEO  JUMP  UaLUE 
arrow  kEY  HOME  RIGHT  SELECTED  JUMP  UaLUE 
ARROW  KEY  MODE  UP  SELECTED  JUMP  UaLUE 
hRROW  KEY  MOUE  DOWN  SELECTED  JUMP  UaLUE 
ESCAPE  KEY  TO  EXIT  PROGRAM 


F0IT_DATA-1 


STATIOljl  332*00  DEPT  45  43  DIST  13*  ? 


E  4.  \ 

P 


-ISO  -10  100  1  210  320  430  540  558  760  87U 
DISTANCE  FROM  LEFT  SIDE  OF  SECTION  LINE  IN  FEET 


EDIT  OATi°i- 


Figure  C28.  Sample  run,  EDIT_DATA 
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EDIT  FEATURES 


Purpose 

EDIT_FEATURES  can  be  used  to  edit  existing  feature  and  label  files  or 
to  create  new  feature  and  label  files  from  scratch. 

Input  files 

NAME. FEAT,  NAME. LABE 
Output  f lie  c 

NAME. FEAT,  NAME. LABE 
External  devices 

Summagraphics  Bit  Pad  1  or  Microgrid  digitizer 
Modules  called 

GETTEXT,  PUT_SCREEN,  GET_XY ,  GET_PEN,  STORE_PEN,  STORE_XY,  ERASE_IT, 
ERASE_WRITE,  PLOTSCRN,  FIND_2_P0INTS ,  CHOSE_POINTS ,  SCHAR,  PLOTLAB,  PROBLEM, 
POLREC,  INITMENU,  DRAWMENU,  MESSAGESTACK,  DRAWFORM,  DISTOFF,  GET_NAME_OF_FILE , 
ROTATE,  DIGITIZER,  DIGITIZER2,  INISOUND,  WRSOUND,  TERMSD,  INISER,  RDSERI , 
WRSERI,  TERMSE,  SCREENLINE,  SCALE_IT_SCREEN ,  UNSCALE_IT_SCREEN , 
UNSCALE_IT_PIXEL,  SCALE_IT_PLOT ,  SCREEN_LINE ,  EQUATION_FROM_2_POINTS , 
INTERSECTION,  POINT_ALONG_A_LINE,  UPDATESCREEN ,  ASCI,  PRINT_SCREEN,  SAVE_IT, 
AUTO_SCALE,  SQUARE_IT_UP ,  RENAME_IT 
Theory  of  operation 

EDIT_FEATURES  begins  by  accepting  the  file  name.  If  the  file  name 
entered  exists,  the  existing  file  is  read;  if  the  file  name  entered  does  not 
exist,  the  program  will  create  a  new  file  of  that  name.  It  then  asks  for  type 
of  digitizer.  It  then  calibrates  the  map  to  digitizer  units.  Next  the  pro¬ 
gram  asks  if  it  should  use  autoscale,  last  window,  keyboard  entered,  or 
digitizer  entered.  Then  the  features  file  is  drawn  to  the  screen  by  the 
method  chosen.  Once  drawn,  the  features  and  labels  file  can  be  edited.  A 
sample  run  is  shown  in  Figure  C29. 

Special  considerations 

Status .  The  program  can  be  used  to  edit  existing  feature  and  label 
files  or  for  beginning  new  feature  and  label  files.  Forms  and  menus  have  not 
been  fully  incorporated  at  present;  some  entries  are  still  done  by  entering  a 
number  or  letter  followed  by  a  carriage  return.  The  current  version  uses 
memory  resident  always. 

Beginning  a  new  feature  with  digitizer.  Select  TEST  and  EDIT_FEATURES . 
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CUT  'WRITE  8  ERhSE  -■ — NOT  IMPLEMENTED 
0  DIGITIZE  h  FEATURE 
E  ERh-JE  a  BLOC  y 

G  GET  K  SThMP  UNSChLED.  GIGE  G  ROTATE.  mOD — HOT  IMP¬ 
LEMENTED 
H  HhF'O  COPY 
^  KEY  X m  H  FEhTUPE 

N  HEW  OUEPhLL  DATA  WINDOW  COORDINATES 

P  PhSTE  h  BLOC  K  GChLED— hot  implemented 

0  QUIT 

S  SA‘'E  h  SThMP  UN’SChLED — NOT  IMPLEMENTED 
U  UNZOOM  TO  OOEPmLL  DhTh  WINDOW 
W  WRITE  H  BLOC!  SChLEO— NOT  IMPLEMENTED 

Z  ZOOM  ON  BLOCK 

1-0  NUMBERED  KEY’:  GET  hRROW  KEY  JUMP  SIZE  ZttKEY 
-  hRROW  KEY  NONE  LEFT  SELECTED  JUMP  UALUE 
ARROW  KEY  HONE  RIGHT  'SELECTED  JUMP  '  ‘HLUE 
ARROW  KEY  MODE  OF  SELECTED  JUMP  UALUE 
hRROW  KEY  MODE  DOWN  SELECTED  JUMP  UALUE 


EDI T_FEhTURES  -  1 


FINISHED 

FILE  NAME _  IL5MTTV  ~  '  - 1 


ENTER  INPUT  FILE  NAME  AMD  CONFIRM 


EDIT.FEATUPES  -  L 


ENTER  EASTING  IN  FEET  FOR  FIRST  POINT 
1 1 040 

ENTER  NORTHING  IN  FEET  POP  FIRST  POINT 

Z5Z0 

PRESS  PEN  DOWN  TO  DIGITIZE  FIRST  POINT 

360  00  '596  00 

SECOND  POINT  SHOULD  BE  IN  THE  LOWER  RIGHT  HAND  CORNE 
P 

AT  THE  SAME  NORTHING  AS  THE  FIRST  POINT 

ENTER  EASTING  IN  FEET  FOP  SECOND  POINT 

PRESS  PEN  DOWN  TO  DIGITIZE  SECOND  POINT 

Z49S  00  S3?  00 

THIRD  POINT  SHOULD  BE  IN  THE  UPPER  RIGHT  HAND  CORNER 
AT  THE  SAME  EhSTING  hS  THE  SECOND  POINT 
ENTER  NORTHING  IN  FEET  FOP  THIRD  POINT 
EDIT.FEATUPES  -  3 


Figure  C29.  Sample  run,  EDIT_FEATURES 
(Continued) 
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K 

AT  THE  SAME  NORTHING  AS  THE  FIRST  POINT 

ENTER  EASTING  IN  FEET  FOR  SECOND  POINT 
Cl  350 

PRESS  PEN  DOWN  TO  DIGITIZE  SECOND  POINT 

2493  00  33T  00 

THIRD  point  should  be  in  the  upper  right  hand  corner 

at  the  ShNE  EASTING  AS  the  SECOND  POINT 

ENTER  NORTHING  IN  FEET  FOR  THIRD  POINT 
1 45'o0 

PRESS  PEN  DOWN  TO  DIGITIZE  THIRD  POINT 

2463  00  2312  00 

ERROR  FROM  90  DEGREE  ANGLE  IS  -0  I 

NEW  WINDOW  INPUT  METHOD 
A  FOR  wUTOSC ALL 
L  FOP  LAST  WINDOW 
k  FOR  KEYBOARD  ENTERED 
D  FOP  USE  DIGITIZER  CALIBRATION  POINTS 
ENTER  H.  L.  K,  OR  D 

EDIT.FEhTURES  -  4 


Figure  C29.  (Concluded) 
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Position  map  on  digitizer  tablet.  Enter  a  nonexistent  file  name  into  the  file 
form  (e.g.,  DD0G7)  and  confirm.  Select  SUMMAGRAPHICS  MICROGRID  digitizer  from 
the  next  form  and  confirm.  Choose  calibration  points  that  are  outside  the 
area  to  be  digitized  (i.e.,  the  edges  of  the  map).  Enter  the  lower  left  east¬ 
ing,  return.  Enter  the  lower  left  northing,  return.  Digitize  the  lower  left 
coordinate.  Enter  the  lower  right  easting,  return.  Digitize  the  lower  right 
coordinate.  Enter  the  the  upper  right  northing,  return.  Digitize  the  upper 
right  coordinate.  For  new  window  input  method,  enter  D,  return.  Proceed  to 
"Entering  changes"  section. 

Beginning  a  new  feature  without  digitizer.  Select  TEST  and 
EDIT_FEATURES .  Enter  a  nonexistent  file  name  into  the  file  form  (e.g.,  DD0G8) 
and  confirm.  Select  NONE  from  file  form  for  digitizer  and  confirm.  For  new 
window  input  method,  enter  K,  return.  Enter  lower  left  easting,  return. 

Enter  upper  right  easting,  return.  Enter  lower  left  northing,  return.  Enter 
upper  right  northing,  return.  Proceed  to  "Entering  changes"  section. 

Editing  an  old  feature  with  digitizer.  Before  beginning,  plot  existing 
file  with  PLOT_FEATURES  and  mount  on  tablet.  Select  TEST  and  EDIT_FEATURES . 
Enter  existing  file  name  into  file  form  (e.g.,  032-3)  and  confirm.  Select  and 
calibrate  digitizer  as  discussed  in  "Beginning  a  new  feature  with  digitizer." 
Choose  one  of  the  new  window  input  methods  (if  unsure,  use  A,  return).  Pro¬ 
ceed  to  "Entering  changes"  section. 

Editing  an  old  feature  without  digitizer.  Select  TEST  and 
EDIT_FEATURES .  Enter  existing  file  name  into  file  form  (e.g.,  032-3)  and  con¬ 
firm.  Choose  one  of  the  new  window  input  methods,  most  likely  A,  and  return. 
Proceed  to  "Entering  changes"  section. 

Entering  changes.  Crosshairs  on  screen  may  be  positioned  either  by 
using  the  arrow  keys  on  the  keyboard  or  by  moving  the  digitizer  pen  and 
depressing  the  button  (last  position  will  be  where  button  released).  Arrow 
key  jump  size  for  one  pixel  is  the  default;  to  change  this,  depress  a  numbered 
key.  Five  is  equivalent  to  one  pixel.  Four  is  equivalent  to  one-half  pixel. 
Six  is  equivalent  to  two  pixels,  and  so  on. 

Functions  may  be  selected  by  depressing  the  appropriate  key: 

Z  Zoom 
U  Unzoom 
E  Erase  a  block 
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B  Backup 

Q  Quit 

L  Enter  a  label 

D  Digitize  a  feature  from  the  digitizer 

K  Digitize  a  feature  using  the  keyboard  arrows  and  screen 

N  Enter  a  new  set  of  window  coordinate  points 
(note:  not  normally  done) 

ESC  Aborts  present  operation 

H  Hard  copy  to  printer  of  screen 

The  functions  are  described  in  more  detail  in  the  following  sections. 

Zoom.  Position  with  the  arrow  keys  or  digitizer  to  one  corner  of  the 
zoom  box.  Press  the  Z  key.  Position  to  the  diagonally  opposite  corner  of  the 

zoom  box  (a  box  will  be  formed  as  the  cursor  is  moved) .  Press  return  to  zoom 

or  ESC  to  abort  zoom.  Note  that  nested  zooms  are  allowed.  You  may  zoom  on  a 
zoomed  area  repeatedly. 

Unzoom.  Press  the  U  key. 

Erase  a  block.  To  erase  a  rectangular  block  from  the  data  on  the  cur¬ 
rent  screen  (screen  may  be  zoomed),  position  with  digitizer  or  arrow  keys  to 

one  corner  of  the  erase  rectangle  and  strike  the  E  key.  Then  position  to  the 
diagonally  opposite  corner  of  the  erase  box  (a  box  will  be  formed  as  the  cur¬ 
sor  is  moved) .  Press  return  and  the  contents  of  the  box  will  be  clipped  from 
the  data  in  memory  or  ESC  to  abort  the  erase.  If  the  lower  left-hand  corner 
of  the  first  letter  of  a  label  is  in  the  box,  the  entire  label  will  be  erased. 

Backup.  B  may  be  entered  to  save  the  current  feature  and  label  informa¬ 
tion  in  memory  to  disk  (or  you  may  wait  until  finished  and  the  exit  routine 
will  ask  whether  or  not  to  save  changes). 

Quit .  Q  is  entered  to  end  the  program.  If  any  unsaved  changes  have 
been  made,  you  will  be  asked  whether  or  not  to  to  save  the  current  memory  con¬ 
tents  to  disk. 

Label .  L  is  entered  to  initiate  label  entry.  Labels  may  be  entered  at 
positions  selected  by  either  the  digitizer  or  arrow  keys  or  both.  When  L  is 
entered,  a  dialog  box  is  opened  on  the  lower  right-hand  corner  of  the  screen. 
The  requested  input  is  displayed  along  with  user  responses.  The  first  input 
is  the  pen  number.  A  one-digit  number  (0-8)  should  be  entered  followed  by  a 
carriage  return.  The  next  input  is  the  label.  A  1-  to  120-character  label 
followed  by  carriage  return  should  be  entered  (backspace  will  remove 
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characters  from  the  back  forward — the  characters  scroll  left  when  more  than  8 
are  entered).  Then  DIGITIZE  FIRST  POINT  Is  displayed.  The  crosshair  is  moved 
using  che  arrow  keys  or  digitizer  to  the  bottom  left-hand  corner  of  the  first 
character's  desired  position.  A  carriage  return  is  entered  to  mark  the  spot. 
Then  DIGITIZE  SECOND  POINT  is  displayed.  The  crosshair  is  moved  to  the  bottom 
right-hand  corner  of  the  last  character's  desired  position.  A  carriage  return 
is  entered  to  mark  the  spot.  The  properly  sized  and  rotated  label  is 
displayed . 

Digitize .  Digitize  works  only  with  a  digitizer.  When  D  is  entered,  a 
dialog  box  is  opened  in  the  lower  right-hand  corner  of  the  screen.  The  box 
requests  the  pen  number  and  a  one-digit  number  (0-8)  is  entered.  The  next 
request  is  for  a  line  type:  a  one-digit  number  (1-7)  is  entered  (2  =  dashed 
line,  5  =  center  line,  7  =  solid  line,  etc.  See  plotter  manual  for  others), 
followed  by  a  carriage  return.  The  computer  then  goes  into  digitize  feature 
mode.  The  crosshair  is  blanked  and  the  computer  waits  for  digitized  data  or 
key  strokes.  To  input  data,  position  the  pen  and  depress  the  button,  moving 
the  pen  in  the  desired  pattern,  or  move  the  pen  to  corners  of  a  polygon  and 
depress  the  pen  momentarily  at  each  corner.  The  digitized  points  will  be  dis¬ 
played  on  the  screen  as  they  are  acquired.  Look  at  the  screen  display.  If  it 
looks  CORRECT,  enter  E  or  return  to  save  the  feature  in  memory.  If  you  do  not 

like  it,  enter  A  to  abort  the  line.  The  computer  will  erase  the  line  from  the 

screen  and  memory.  (Note:  if  the  line  crosses  another  line  or  label,  parts 
of  the  line  or  label  may  be  erased  on  screen,  but  not  in  memory;  U  may  be 
entered  to  redraw  the  screen  if  this  is  bothersome.) 

Key-entered  features.  K  may  be  used  to  enter  a  feature  from  key. 
Features  are  entered  from  key  by  using  the  digitizer  pen  or  arrow  keys  to 
position  and  the  carriage  return  to  mark  each  point  of  the  feature.  A  feature 

is  ended  by  entering  E  to  save  in  memory  or  A  to  abort  and  discard.  Entering 

E  causes  a  dialog  box  to  form  in  the  lower  right-hand  corner.  The  pen  number 
for  the  feature  0-8  is  entered  as  a  one-digit  number  followed  by  a  carriage 
return.  Then  the  line  type  for  the  feature  is  entered  as  a  one-digit  number 
followed  by  a  carriage  return  (2  =  dashed  line,  5  =  center  line,  7  =  solid 
line,  etc.  See  plotter  manual  for  definition  of  line  types.).  Then  the 
program  goes  into  digitize  mode.  Move  the  crosshairs  to  the  first  desired 
position  and  hit  return.  Then  move  to  each  successive  position  hitting  re¬ 
turns  until  finished.  If  the  line  on  the  screen  looks  correct,  hit  E  to  save 
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it;  if  not,  enter  A  to  abort  it.  If  the  line  is  not  cleanly  erased  when  A  is 
hit,  you  may  use  V  to  redraw  the  screen  (the  line  has  been  cleanly  erased  in 
memory;  only  the  display  is  at  fault). 

NEW _WINDOW.  NEW  WINDOW  automatically  comes  up  at  the  beginning  of  the 
.rogram  and  may  be  selected  during  the  program  by  depressing  N.  NEW  WINDOW 
sets  the  coordinates  of  the  unzoomed  screen  display.  It  asks  that  A ,  L,  K,  or 
C  be  entered. 

A  (for  AUTO_SCALE)  searches  the  .FEAT  and  .LABE  files  (on  disk  or  in 
memory)  and  finds  the  minimum  and  maximum  x  and  y.  The  lower  left-hand  corner 
is  set  to  MINX  and  MINY,  the  upper  right-hand  corner  is  set  to  MAXX  and  MAXY. 

L  (for  LAST_WINDOW)  instructs  the  user  to  use  LAST_WINDOW.  Each  time  a 
new  window  is  selected,  its  coordinates  are  saved  in  a  file  called  LAST_SCALE. 
If  L  is  selected,  the  contents  of  this  file  are  read  and  used.  If  desired, 
LAST_SCALE  may  be  edited  with  the  text  editor  after  running  the  program  to  see 
the  coordinates  (for  future  use). 

K  (for  KEYBOARD_ENTERED)  requests  the  user  to  enter  coordinates  for 
upper  right  and  lower  left  from  key.  The  coordinates  from  a  previous 
AUTO_SCALE  could  be  used. 

D  (for  DIGITIZER_ENTERED)  requests  the  user  to  use  coordinates  from 
digitizer  calibration.  If  the  digitizer  was  calibrated  to  include  the  entire 
area,  this  may  be  the  best  choice. 

if  using  existing  files,  A  or  L  might  be  best.  If  using  a  new  map,  D  or 
A'  might  be  best . 

Escape .  The  escape  key  aborts  the  present  operation:  (1)  zoom, 

(2)  erase,  (3)  digitize  feature,  or  (4)  key  in  feature.  The  operation  will 
not  be  completed  and  its  effects  are  removed.  Once  the  operation  is 
completed,  escape  has  no  function. 

Hard  copy.  The  H  key  causes  the  screen  to  be  dumped  to  the  printer  pro¬ 
viding  a  hard  copy  of  the  present  contents  including  crosshair  reading.  Since 
the  crosshair  reading  is  always  current,  the  position  of  a  point  can  be  found 
and  recorded  to  paper  using  this  feature. 

Example  run.  Copy  the  files  LOCALITY , FEAT  and  LOCALITY. LABE  to  hard 
disk  under  the  MULTITASK  subject.  Run  PLOT_FEATURES  to  plot  the  map  (to  the 
size  of  your  digitizing  tablet  If  you  have  one).  The  map  has  an  outline  that 
may  be  used  for  calibrating  the  digitizer;  the  coordinates  of  the  left-hand 
corner  are  (11040,  7520)  and  of  the  upper  right-hand  corner  are  (21950, 
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14580)  .  In  the  following  description,  choose  nondigitizer  options  if  you 
do  not  have  one  instead  of  the  options  listed. 

Mount  the  paper  on  the  digitizer.  Run  TEST  "EDIT_FEATURES"  from  the 
MULTITASK  DEVELOP  file.  When  the  digitizer  form  is  displayed,  select 
MICROGRID  as  the  digitizer  using  one  left-cursor  motion  (if  you  have  a 
digitizer;  otherwise,  select  NONE)  and  confirm.  When  the  file  form  is  dis¬ 
played,  enter  LOCALITY  and  confirm  (code-return).  The  digitizer  calibration 
portion  will  begin.  Follow  the  instructions  by  ertering: 

(1)  11040,  carriage  re' urn 

(2)  7520,  carriage  return 

(3)  Locate  pen  at  lower  left-hand  corner  of  outline  box  and  press 
button  to  digitize  first  point 

(4)  21950,  carriage  return 

(5)  Locate  pen  at  lower  right-hand  corner  of  outline  box  and 
press  button  to  digitize  second  point 

(6)  14580,  carriage  return 

(7)  Locate  pen  at  upper  right-hand  corner  of  outline  box  and 
press  button  to  digitize  third  point 

(8)  If  the  points  are  accurately  entered,  the  new  window  option 
is  displayed.  Enter  A,  carriage  return. 

The  LOCALITY. FEAT  and  .LABE  files  should  be  drawn  on  the  screen.  Wait 
until  the  screen  is  completely  drawn  and  the  crosshair  is  displayed.  Move  the 
crosshair  using  the  arrow  keys.  Depress  8  and  the  crosshair  will  move  more 
quickly;  depress  3  and  it  will  move  by  partial  pixels,  allowing  more  resolu¬ 
tion  when  entering  coordinates  from  the  crosshair.  Depress  5  and  the  cross¬ 
hair  will  again  rove  at  its  normal  rate.  Use  the  digitizer  pen  to  position 
the  cursor.  Move  the  pen  to  a  point  on  the  map  and  press  the  button.  The 
crosshair  will  jump  to  that  point  on  the  screen. 

Test  the  zoom  feature.  Position  the  crosshair  to  some  point  on  the 
screen.  Depress  Z.  Expand  the  box  (the  crosshair  has  been  replaced)  to  sur¬ 
round  a  small  section  of  the  screen.  Depress  return,  and  the  screen  will  be 
redrawn;  wait  until  the  crosshair  reappears.  Test  nested  zooms  by  positioning 
to  a  point  on  the  screen  and  depressing  Z.  Then  expand  the  box  and  depress 
return.  The  screen  will  zoom  again.  Test  the  hard  copy  feature  by  pressing  h 
to  print  the  screen.  Test  the  unzoom  feature  by  depressing  U  to  return  the 
screen  to  its  initial  display. 

Test  entering  labels.  Enter  L.  The  label  dialog  box  will  appear  In  the 
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lower  left-hand  corner  of  the  screen.  For  pen  number  enter  1,  carriage 
return.  For  label,  enter  "WHAT  AN  AWEE^(backspace)  >SOME  PROGRAM,"  carriage 
return.  Position  the  crosshair  where  you  want  the  lower  right-hand  corner  of 
the  lacel  to  be  and  enter  a  carriage  return.  The  label  is  drawn  on  the  screen 
and  saved  in  memory  (a  flag  in  the  program  is  set  to  let  it  know  the  file  has 
been  modified).  Test  digitizing  features  for  the  digitizer  by  entering  l. 

The  DIGITIZE  FEATURES  dialog  bcx  appears.  Enter  the  pen  number  1,  carriage 
return.  Enter  the  line  type  7  (solid  line),  carriage  return.  The  program 
goes  into  digitize  mode,  the  crosshair  is  blanked.  Move  it  from  one  point  to 
another  depressing  the  button  at  each  point.  Your  pattern  is  displayed  on 
screen.  Depress  E  or  carriage  return  to  save  the  feature  (A  or  ESC  if  you  do 
not  want  to  save  it)  . 

Test  digitizing  features  from  the  keyboard  by  entering  K.  The 
KEYED  FEATURES  dialog  box  appears.  Enter  the  pen  number  1,  carriage  return. 
Enter  the  line  type  7  (solid  line),  carriage  return.  Move  the  crosshair  using 
the  arrow  keys  to  the  desired  point,  and  press  the  carriage  return  to  digitize 
the  first  point.  Move  the  crosshair  to  the  next  point  and  press  the  carriage 
return  to  digitize  the  second  point.  Continue  in  this  manner  until  the 
desired  feature  is  displayed  on  the  screen.  Enter  E  to  end  and  save  (or  A  or 
LSC  to  abort  the  save). 

Test  erasing  a  block.  Position  the  crosshair  to  a  corner  of  the  rect¬ 
angle  to  be  erased.  Enter  E.  Enlarge  the  box  using  the  arrow  keys  or 
digitizer  to  surround  the  area  to  be  erased  and  enter  a  carriage  return.  The 
screen  should  be  redrawn  with  the  area  within  the  erase  rectangle  deleted. 
Features  are  cropped  at  the  edges  leaving  partial  features.  Labels  are  re¬ 
moved  fully  if  the  lower  left-hand  corner  was  within  the  erase  rectangle. 

Enter  to  quit.  Since  the  files  were  modified,  the  computer  will 
display  the  unsaved  method.  Normally  you  would  enter  Y  and  carriage  return  to 
save  the  modifications,  but  for  now  enter  ,7,  carriage  return  to  exit  without 
saving  the  changes  and  the  changes  will  not  take  effect. 
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EQUIPMENT  ENTRY 


Purpose 

EQUIPMENT_ENTRY  defines  the  equipment-specific  information  for  a  survey 

site . 

Input  files 

NAME . EQUI 
Output  files 

NAME. EQUI 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU ,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  GET_NAME_OF_FILE 
Theory  of  operation 

EQUIPMENT_ENTRY  displays  an  input  file  form  and  reads  information  to  be 
modified  from  the  file.  It  then  displays  a  series  of  triordinate  input  forms 
until  the  operator  sets  MORE  to  NO.  It  then  displays  the  equipment  form  and 
allows  Input  of  equipment  to  be  used.  The  flowchart  is  shown  in  Figure  C30, 
and  a  sample  run  is  shown  in  Figure  C3I. 

Special  considerations 

This  program  must  be  run  prior  to  a  section  line,  random,  or  find-spot 
survey.  Simulation  of  either  range  or  depth  device  may  be  specified  for 
checkout  purposes.  For  range  azimuth,  transponder  triordinates  are  entered  in 
pairs:  (1)  theodolite  position  and  (2)  backsight. 
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initialize  form 

POINTERS 


DISPLAY  INPUT 
PILE  FORM 


Figure  C30.  Flowchart 
EQUIPMENT  ENTRY 


MUttttlttllttMIMtMMItUtltMKMItllt 

CODE  PETIJPH  COMF1  PM?  A  FOPM 

ESCAPE  <NOT  CODE  ESCAPE  ALLOWS  ESCAPING 


NO  INPUT  FILE 


INPUT  FILE  UmI'IE 


ENTER  INPUT  FILE  NAME  AND  CONFIRM 


equifment_entrt-i 


CODE  PETIJPH  CONFIRMS  H  FOPM 

ESChFE  not  CODE  ESCAPE <  ALLOWS  ESCAPING 


HEIGHT  10  0000 

MORE  TRANSPONDERS  hFTER  THIS5  YES 


ENTER  TRANSPONDER  TR I  ORDINATES  NO  1 


EQUIPMENT  ENTRY-2 


1 1  M  1  M  *  M  *«  M»  tmtUt.NNtHtM  MM  MM  t  * 

CODE  RETURN  CONFIRMS  h  FOPM 

ESCAPE  -  NOT  CODE  ESCAPE  ALLOWS  ESCAPING 


EASTING 
NORTHING 

HEIGHT  10  oono 

MORE  TRANSPONDERS  AFTER  THIS"  NO 


ENTER  TRANSPONDER  TPIORDIHATES  HO 


EQUIPMENT  ENTRY-3 


iitiiitttittitMNitmnmmimtmtKt 

CODE  RETURN  CONFIRMS  A  FORM 

ESCAPE  i  HOT  CODE  ESCAPE  •  ALLOWS  ESCAPING 


.  ;  <E-ic  polaRF i:’SEP1hi  geodimet hot 

OUTPUT  FILE  NhME  CPuUFE _ 

RANGE  EQUIPMENT  I IMC 
DEPTH  EOUIF'MENT  PIN^.FACE  g£  l 

BOaT  hHTGNNh  HEIGHT  10  0000 

Pi::  MAPI  S  FEET 

FI  MAPI  INTERNAL  10  0000 


FILL  IN  EQUIPMENT  FORM  AND  CONFIRM 


EGUIPMF.NT_ENTRy-4 

Figure  C31.  Sample  run,  EQUIPMENT  ENTRY 
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FIND  SPOT 


Purpose 

FIND_SPOT  is  a  survey  task  designed  to  display  spot-type  surveys  and 
accept  operator  run-time  inputs.  It  is  intended  for  guiding  the  pilot  to  pre 
defined  coordinates. 

Input  files 

NONE  (uses  common  block  of  memory  for  data  passing) 

Output  files 

.M001,  .D00I  (where  001  is  mark  or  tide  entry  number) 

External  Devices 
NONE 

Modules  called 

ASCII,  UPDATESCREEN,  POLREC,  A2 ,  PROBLEM,  INISOUND,  WRSOUND,  TERMSD 
Theory  of  operation 

FIND_SPOT  begins  by  displaying  the  first  spot  on  screen.  It  loops  wait 
ing  for  a  key  to  be  pressed  and  updating  the  screen.  If  E  is  pressed,  the 
spot  number  is  incremented  and  the  next  spot  displayed.  The  flowchart  is 
shown  in  Figure  C32. 

Special  considerations 

FIND_SPOT  does  not  automatically  save  any  data.  The  M  key  must  be 
pressed  to  mark  a  spot  and  save  data. 
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Figure  C32.  Flowchart,  FIND_SP9T 
(Continued) 


Figure  C32.  (Concluded) 


GENERIC  TO  GRID  FORMAT 


Purpose 

GENERIC_TO_GRID_FORMAT  was  developed  to  ease  the  import  of  data 
collected  on  other  systems  into  the  small-boat  postsurvey  package.  Data  files 
are  normally  stored  in  binary  format  to  reduce  storage  space  required;  all 
analysis  programs  expect  this  input .  Also  each  line  is  normally  stored  in  a 
separate  file.  To  ease  import  of  data,  an  ASCII  file  on  IBM*-formatted  disk 
is  specified  for  contractor  interface.  Contractors  provide  data  in  this 
generic  format  and  it  is  converted  to  Grid  format  by  tb-'  program-  Therefore 
contractors  need  only  be  able  to  provide  5.25-in.  360-kB  standard  floppy 
diskettes  in  the  specified  data  layout. 

Input  files 

INPUT  NAME  (read  from  key) 

Output  files 

OUTPUT  NAME  (read  from  input  file,  site, 0001) 

External  devices 

NONE 

Modules  called 

PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK,  DRAWFORM,  GET_NAME_0 F_F I LE 
Theory  of  operation 

Data  are  read  in  ASCII  format,  converted  and  written  out  in  binary.  A 
flowchart  is  shown  in  Figure  C33. 


*  IBM  is  a  registered  trademark  of  the  International  Business  Machines 
Corporation . 
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J 


Figure  C33.  Flowchart, 
GENERIC  TO  GRID  FORMAT 
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INDICATOR 


Purpose 

INDICATOR  is  a  program  used  to  produce  the  pilot  (helmsman)  indicator 
meter  display  and  to  accept  option  changes  via  function  keys  from  the  pilot. 

It  runs  on  the  TRS  80  Model  100  or  102  computer*  and  normally  displays  an  off¬ 
line  and  distance-along-the-line  indicator. 

Input  files 

NONE  (data  are  received  via  the  modem  port) 

Output  files 

NONE 

External  devices 

NONE 

Modules  called 

1000,  910,  920,  930,  940,  950,  960,  970,  980,  3600,  3650,  3500,  3550, 
3200,  3100,  3150,  3000,  3050,  2800,  2805,  2880 
Theory  of  operation 

The  TRS  80  pilot  indicator  program  is  written  in  BASIC  (all  other  pro¬ 
grams  are  FORTRAN)  and  runs  on  a  TRS  80  model  100  or  102  Executive  Workslate. 
The  flowchart  is  shown  in  Figure  C34.  Two  basic  indicator  displays  are 
available . 

One  is  a  plan  view  of  the  section  line  (called  the  plan  view  display), 
which  contains  a  distance  meter  along  with  an  offline  indicator.  This 
indicator  displays  a  boat  that  sails  toward  the  center  as  the  survey  boat 
sails  toward  the  survey  line  and  a  boat  that  sails  from  the  center  as  the  sur¬ 
vey  boat  sails  away  from  the  line.  If  the  boat's  course  is  close  to  parallel 
to  the  section  line  or  if  the  boat  is  on  the  section  line,  a  boat  sailing 
straight  ahead  is  displayed.  The  distance  meter  is  a  bar  graph-type  meter 
that  darkens  the  percent  of  total  line  length  traversed. 

The  other  indicator  display  (called  the  meter  display)  shows  two 
enlarged  meters  for  distance  and  offline.  The  offline  meter  is  a  conventional 
pointer-type  meter.  The  distance  meter  is  a  bar  graph  type  similar  to  the 
plan  view  version.  Function  pushbuttons  on  the  front  of  the  TRS  80  control 
the  scale  changes: 


*  TRS  80  is  a  registered  trademark  of  the  Tandy  Corporation. 
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CHANGE  SCALE  OR 
DISPLAY  TYPE  OR 
AUTOMATIC  ' MANUAL 
OPTIONS  ACCORDING 
TO  FUNCTION  KEY 


Figure  C3A.  Flowchart,  INDICATOR 
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a.  FI  causes  the  offline  meter  to  drop  to  a  lower  range  each  time 
it  is  depressed.  For  example,  if  the  scale  is  -50  to  50  before 
FI  is  depressed,  it  will  be  -20  to  20  afterwards. 

b.  F2  causes  the  offline  meter  to  jump  to  a  higher  range  each  time 
it  is  depressed.  For  example,  if  the  scale  is  -100  to  100 
before  F2  is  depressed,  it  will  be  -200  to  200  afterwards. 

c.  F3  causes  the  display  to  toggle  from  the  plan  view  display  to 
the  meter  display,  or  vice  versa,  depending  on  the  current 
display . 

d.  F4  causes  the  plan  view  display  to  toggle  from  normal  to  large 
area. 

e.  F5  toggles  the  enabling  or  disabling  of  automatic  offset  meter 
scale  changing  by  the  program;  i.e.,  if  automatic  scale  changing 
is  enabled  and  if  the  meter  pegs,  the  program  will  effectively 
push  F2.  Or  if  the  indicator  falls  within  15  percent  of  the 
meter  center,  the  program  will  effectively  push  FI. 

_f .  F6  toggles  the  enabling  or  disabling  of  automatic  plan  view  nor¬ 
mal  to  large  area  switching;  i.e.,  if  the  boat  position  falls 
within  the  bounds  of  the  normal  size  plan  view,  this  view  is 
used;  otherwise,  the  large  area  is  used,  if  auto  switching  is 
enabled. 

g.  F7  toggles  enabling  or  disabling  auto  switch  from  plan  to  meter 
display  at  the  beginning  and  end  of  line;  i.e.,  if  auto  switch 
is  enabled,  the  plan  view  will  be  displayed  automatically  any 
time  new  line  coordinates  are  received  by  the  TRS  80  from  the 
Grid  Compass,*  and  the  meter  view  will  be  displayed  automati¬ 
cally  when  the  distance  along  the  line  changes  from  negative  to 
positive. 

h.  F8  causes  the  display  to  be  redrawn  (in  case  some  unforeseen 
circumstance  causes  the  display  to  be  garbage) . 


There  are  two  scales  of  plan  view  based  on  the  length  of  the  survey  line: 

a.  A  large  area  display  used  for  initially  finding  the  line. 

b.  A  normal  display  for  use  when  close  to  the  line. 

There  are  six  different  offline  meter  scales: 

a.  -10  to  10 

b.  -20  to  20 

c.  -50  to  50 

d.  -100  to  100 

e.  -200  to  200 

f.  -500  to  500 

Scales  may  be  either  manually  selected  by  the  pilot  or  automatically  selected 


*  Compass  is  a  trade  name  of  Grid  Systems,  Inc. 


C83 


by  the  TRS  80  program.  Letters  are  displayed  on  the  lower  left-hand  portion 
of  the  TRS  80  display  to  indicate  the  current  state  of  automatic  feature 
enables.  F5's  current  state  is  displayed  by  the  letters  MM  if  disabled  (i.e., 
manual  meter  range)  or  AM  if  enabled  (i.e.,  automatic  meter  range).  F6's  cur¬ 
rent  state  is  displayed  by  the  letters  MP  if  disabled  (i.e.,  manual  plan  view 
scale)  or  AF  if  enabled  (i.e.,  automatic  plan  view  scale).  F7 ' s  current  state 
is  displayed  by  the  letters  MS  if  disabled  (i.e.,  manual  switch  of  displays) 
or  AS  if  enabled  (i.e.,  automatic  switch  of  displays).  Also  the  beginning 
(El,  N2)  coordinates  of  the  current  line  and  plan  view  scale  in  feet/inches 
are  displayed. 

Special  considerations 

The  INDICATOR  program  normally  stays  in  the  memory  of  the  TRS  80  model 
100  or  102  computer.  This  memory  is  maintained  by  four  AA  batteries  in  the 
TRS  80.  If  the  batteries  need  replacing,  first  power  the  unit  up  with  the  AC 
adapter  and  then  replace  the  batteries.  If  the  program  is  lost,  it  is  stored 
on  the  Grid  computer  in  a  file  called  INDICATOR  and  may  be  downloaded  to  the 
TRS  80.  First  connect  the  two  with  a  phone-type  modular  connector  cable. 
Select  BASIC  on  the  TRS  80  and  type  in  the  command  LOAD  "MDM: 7E1E";  the  TRS  80 
should  emit  the  typical  modem  tone.  Select  GRIDTERM  on  the  Grid  computer  (the 
default  options  are  normally  7  bits  even  parity  as  needed — otherwise  change 
them).  Set  the  baud  rate  to  300,  the  phone  number  to  0,  and  confirm.  Then 
select  "Code  T"  and  "Send  a  file."  Choose  the  file  INDICATOR  with  no  special 
character  transmission.  The  transfer  takes  several  minutes. 
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INTERS ECTI0N_0F_2_LINES 

Purpose 

INTERSECTION_OF_2_LINES  finds  the  coordinate  where  two  lines  intersect. 
This  is  useful  for  deriving  coordinates  for  channel  toes  at  points  where  they 
are  not  given.  NEW_LINE_INPUT  requires  coordinates  of  all  lines  at  any  bend; 
sometimes  left  and  right  channel  bends  do  not  coincide  and  intermediate  points 
must  be  calculated. 

Input  files 

TEMPLINE 
Output  files 

TEMPLINE 
External  devices 
NONE 

Modules  called 

INITMENU ,  ADDRESS,  CHANNEL_MESSAGE ,  DRAWFORM,  EQUATI0N_FR0M_2_P0INTS , 
INTERSECTION,  A 2,  MESSAGESTACK 
Theory  of  operation 

The  program  first  reads  in  the  last  set  of  coordinates  used  from  a 
temporary  disk  file,  TEMPLINE.  Then  a  form  for  line  coordinate  input  is  dis¬ 
played  by  calling  DRAWFORM.  If  the  quit  option  was  selected  (i.e.,  NCH0S1  is 
returned  as  2),  the  last  set  of  coordinates  is  saved  in  TEMPLINE  and  the  pro¬ 
gram  is  ended.  Otherwise,  the  line  equations  (Ax  +  By  +  C  =  0)  are  generated 
by  calling  INTERSECTION.  The  results  are  displayed  by  calling  MESSAGESTACK. 
The  process  then  repeats  with  redisplay  of  the  form.  The  flowchart  is  shown 
in  Figure  C35,  and  a  sample  run  is  shown  in  Figure  C36. 

Special  considerations 
NONE 
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Figure  C35.  Flowchart, 
INTERSECTION  OF  2  LINES 


Figure  C36.  Sample  run, 
INTERSECTION  OF  2  LINES 
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MANUAL  SURVEY  ENTRY 


Purpose 

MANUAL  SURVEY_ENTRY  accepts  survey  depths  from  key.  It  is  used  to  input 
data  available  from  no  other  source  than  a  notebook;  i.e.,  it  is  not  available 
on  disk  or  in  plotted  form. 

Input  files 

NAE.LINE 
Output  files 

NAME. 0001  (where  .0001  is  line  number) 

External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU ,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  GET_NAME_OF_FILE, 
DISTOFF,  POLREC,  A2 
Theory  of  operation 

MANUAL_SURVEY_ENTRY  begins  by  displaying  a  file  form  and  reading  in  the 
.LINE  file.  It  then  displays  a  line  entry  form  for  the  line  number  to  be 
processed.  It  accepts  date  and  other  parameters,  then  loops  through  output¬ 
ting  a  distance  along  the  line  and  asking  for  the  corresponding  depth.  Output 
is  a  .0001  file  in  the  same  format  as  lines  acquired  by  automated  surveys. 

The  flowchart  is  shown  in  Figure  C37,  and  a  sample  run  is  shown  in  Figure  C38. 
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Figure  C37.  Flowchart,  MANUAL  SURVEY  ENTRY 
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Figure  C38.  Sample  run,  MANUAL  SURVEY  ENTRY 


MARKS  HARRIS 


Purpose 

MARKS_HARRIS  converts  mark  files  from  binary  form  to  an  ASCII  format 
required  by  a  Louisville  District  program. 

Input  files 

NAME. MOO 1  (where  001  is  the  mark  number) 

Output  files 

MARKS_HARRIS 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU ,  DRAWMENU ,  MESSAGESTACK ,  DRAWFORM,  GET_NAME_OF_FILE 
Theory  of  operation 

MARKS_HARRIS  displays  a  form  for  site  name  input.  It  loops  through 
reading  in  the  .M001  files,  converting  them  to  time  and  easting-northing  for¬ 
mat,  and  writing  them  out.  A  flowchart  is  shown  in  Figure  C39. 
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DISPLAY  FILE  FORM 


Figure  C39.  Flowchart, 
MARKS  HARRIS 
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MARKS_T0_DESCRIPT0R 

Purpose 

MARKS_TO_DESCRIPTOR  creates  a  .MARK  file  for  input  to  the  PLAN_PLOT  pro¬ 
gram  so  that  marks  can  be  plotted  using  the  desired  pen,  special  symbol,  and 
label. 

Input  files 

NAME.M001  (where  001  is  the  mark  number) 

Output  files 

TEMP,  NAME. MARK 
External  equipment 
NONE 

Modules  called 

PROBLEM,  INITMENU ,  DRAWMENU,  MESSAGESTACK,  DRAWFORM,  GET_NAME_OF_FILE 
Theory  of  operation 

MARKS_TO_DESCRIPTOR  displays  a  file  form  for  the  base  name  of  the  input 
and  output  files.  It  combines  easting-northing-depths  from  the  .M001  files 
wli.ii  label  information  from  key  and  writes  them  to  a  file  called  TEMP.  Number 
of  marks  is  counted  and  written  to  the  NAME. MARK  file  followed  by  all  the  data 
in  TEMP.  A  flowchart  is  shown  in  Figure  C40. 
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DISPLAY  FORM 
FOR  INPUT  FILE 


Figure  C40.  Flowchart, 
MARKS  TO  DESCRIPTOR 
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MARKS  TO  FEATURES 


Purpose 

MARKS_TO_FEATURES  allows  marks  collected  with  the  survey  boat  to  be  con¬ 
verted  to  features  (shorelines  and  other  segmented  curves). 

Input  files 

NAME.M001  (where  001  is  mark  number) 

Output  files 

NAME. FEAT 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK,  DRAWFORM,  GET_NAME_OF_FILE 
Theory  of  operation 

MARKS_TO_FEATURES  accepts  the  site  name  and  opens  a  .MARK  file.  It  then 
processes  features  as  the  operator  inputs.  The  operator  specifies  which  marks 
are  to  be  combined  to  make  a  feature  and  what  the  feature  should  look  like. 

The  features  specified  are  output  to  a  .FEAT  file.  The  flowchart  Is  shown  in 
Figure  CA1. 
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Figure  C41.  Flowchart, 
MARKS  TO  FEATURES 


MARK  DESCRIPTION 


Purpose 

MARK_DESCRIPTION  accepts  mark  information  from  key  and  builds  a  .MARK 
file  for  use  by  PLAN_PLOT  in  determining  how  to  plot  marks.  It  is  used  for 
marks  not  acquired  by  the  survey  program. 

Input  files 
NONE 

Output  files 

NAME. MARK 
External  devices 
NONE 


Modules  called 


PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  GET  NAME  OF  FILE 


Theory  of  operation 

MARK_DESCRIPTION  begins  by  displaying  a  file  form  and  accepting  the  out 
put  file  name.  It  then  asks  for  the  number  of  marks  to  be  entered  and  loops 
accepting  information:  (1)  plotter  pen  carriage  slot,  (2)  special  symbol  pat 
tern,  (3)  symbol  height,  (4)  easting,  (5)  northing,  and  (6)  label.  The  flow¬ 
chart  is  shown  in  Figure  C42 ,  and  a  sample  run  is  shown  in  Figure  C43. 

Special  considerations 


MARK_DESCRIPTION  is  used  to  enter  marks  not  collected  by  the  survey  pro 
gram.  MARKS_TO_DESCRIPTOR  handles  automatically  collected  marks.  The  text 
editor  can  be  used  to  combine  mark  files  (but  remember  to  add  the  two  numbers 
of  marks  and  put  the  sum  at  the  beginning  while  deleting  the  two  addends. 
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OUTPUT  FILENhHE  <  -l  TO  .-.top  .  iL'uUI^i ULLE 


ENI££.J_NPUT*FILE  NHME  HNCl  CONFIRM 


MARK  DESCRIPTION-1 


ENTER  NUMBER  OF  POSITIONS  TO  BE  MhRKEO 

THF  FOLLOWING  INFO  IS  FOP  HOPE  NUMBER  1 
ENTEP  PEN  NUMBER 

1 

ENTEP  SPEC  I  hL  SYMBOL  IUMBEP 
4 

ENTEP  SPEC  1 hL  SYMBOL  SICE  IN  INCHES 

ENTEP  EASTING 
7*52"3!4'?  ° 

ENTER  NORTHING 
337676 
ENTER  LhBEL 

HUNTINGTON  DISTRICT'S  LIGHTHOUSE 
THE  FOLLOWING  INFO  IS  FOR  MrRP  NUMBER  "■ 
ENTER  PEN  NUMBER 

ENTER  SFECIhL  SYMBOL  NUMBER 


MARK_DESCR IPT I ON-2 


Figure  C42.  Flowchart, 

MA.?_K  DESCRIPTION  Figure  C43.  Sample  run,  MARK  DESCRIPTION 
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MOB I LE_QUANT ITY_FORMAT 


Purpose 

The  CROSS_SECTION_AND_DREDGING  program  produces  a  large  quantity  of  in¬ 
formation  (approximately  9  pages) .  MOBII.E_QUANTITY_FORMAT  grabs  portions  cf 
this  information  and  prints  it  on  a  one-page  form.  This  program  works  with 
dual  survey  results:  predredge  and  postdredge  giving  required,  overdepth,  and 
total  removed. 

Input  files 

QUANTITIES 
Output  files 
NONE 

Required  hardware 
Printer 

Modules  called 
SKIP 

Theory  of  operation 

MOBILE_QUANTITY_FORMAT  begins  by  getting  the  date/time  from  the  system 
clock.  It  then  opens  QUANTITIES  and  gets  the  date  the  survey  was  run.  It 
draws  the  form  and  fills  it  in  as  it  goes  using  the  following  information 
(station  number,  required  area,  net  area,  overdredge  area,  gross  area,  net 
volume,  overdredge  volume,  and  gross  volume).  The  flowchart  is  shown  in 
Figure  C44,  and  a  sample  run  is  shown  in  Figure  C45. 

Special  considerations 

CROSS_SECTION_AND_DREDGING  must  have  been  run  prior  to  this  program  with 
pre-  and  postsurvey  data. 
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Figure  C44.  Flowchart, 

MOBI LE_QUANT I TY_FORMAT 

YARDAGE  COMPUTATIONS 

LOCATION _ _ _ BY _ 

DATES  SURVEYED:  S-24-89,  5-23-89  DATE  COMPUTED'  06-06-89  SHEET  NO.  1  OF  ! 

- + - CptDIT  AREAS - -  + - CREDIT  VOLUMES - 

STA  NO.  -REQUIRE:  NET  0 .  D .  GROSS  :  REQUIRED-'  NET  :  O.D  GROSS 

-------- - --  -f - f - + - "I - - - - ;  • 

332+00  :  1.3:  1.3:  0.0:  26.4: - + - + - + - 

- - -  - - + - - - + - + - 1- - :  452.:  452.:  0.:  610. 

334+00:  120.7:  120.7:  0.0:  138.2:  + - + - + - 

- + - t - + - + - :  -133.:  -133.:  0.:  -'129. 

336  +  00:  -156.6:  -156.6-  0.0=  -173.2: - + - + - + - 

- + - + - + - + - :  -  1  J  1  8  .  :  —  1  J  1  8  .  :  0.:  “1566. 

233  +  00:  -199.2-  -199.2:  0.0:  -249 . 5  ; - + - h - + - 

— + - -  —  + - -  +  -■ - + - :  -  1  4  6  J  .  :  -  1  4  6  4  .  :  0.:  -  1  5  .j  6  . 

340  +  00  -  '  1  9b  .  0  :  "195.0'  0.0:  -164.5:  + - + - -I - 

- + - + - + - + - :  19.  :  19.  :  0.  :  382  . 

312+00:  00 . 1  200.  j  0.0:  267. 6  : - H - +  -  -  -  . —  + - 

TOTALS  -2442.  -2442.  0.  -2240. 


MOBILE_QUAMT IT Y  _FORMAT- i 

Figure  C45.  Sample  run,  MOBILE_QUANTI'T'Y_FORMAT 
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MOBILE  SINGLE  QUANTITY 


I 

Purpose 

The  CROSS_SECTION_AND_DREDGING  program  produces  a  large  quantity  of  in¬ 
formation  (approximately  9  pages).  MOBILE_SINGLE_QUANTITY  grabs  portions  of 
this  information  and  prints  it  on  a  one-page  form.  This  program  works  with  a 
single  survey  giving  required  and  overdepth  dredging  quantities. 

Inpue  files 

QUANTITIES 
Output  files 
NONE 

Required  hardware 
Printer 

Modules  called 
SKIP 

Theory  of  operation 

MOBILE_SINGLE_QUANTITY  begins  by  getting  the  date/time  from  the  system 
clock.  It  then  opens  QUANTITIES  and  gets  the  date  the  survey  was  run.  It 
draws  the  form  and  fills  it  in  as  it  goes  using  the  following  information: 
station  number,  required  area,  net  area,  overdredge  area,  net  volume,  and 
overdredge  volume.  The  flowchart  is  shown  in  Figure  C46,  and  a  sample  run  is 
shown  in  Figure  C47. 

Special  considerations 

CROSS_SECTION_AND__DREDGING  must  have  been  run  prior  to  this  program  with 
pre-  and  postsurvey  data. 


GET  DATE  *,  TIME 
FROM  SYSTEM 


OPEH  THE  QUANTITIES  FILE  FROM 
SINGLE  SUP1  '£  T  COMPUThT  ION 


PRINT  SELECTED  BITS  OF  INFORMATION 
FROM  QUANTITIES  aNO  LINES  AS 
NEEDED  "0  GIUE  APPEARANCE  OF  FORM 


Figure  C46.  Flowchart, 
MOBILE  SINGLE  QUANTITY 


YARDAGE  COMPUTATIONS 


DATE  COMPUTED 


+ 


9994.:  :  '199.0 


ry 


BY 


:  0b “SB -59 

SHEET  NO.  1  OF  1 

P.  E  0  U I R  E  0  ; 

-  VOLUMES  - 

NET  0.0. 

3550 ! . S • 

4  4  4  0  9 . b •  be?  4 . 9 

3 1  1  i  4  .  1  • 

3  9  9  5  S  .  6  ■  *384.5 

30374 . 5 

39259.4:  9834.9 

ZB  140. 5- 

4  b  0  9  .  p  :  0  b  b  4 . 9 

4 1 3c  i  .  : 

b  0  c.  4  b  .  j  .  :<  b  9  4  .  9 

0  !  3  U  3  .  6  4.1434 . 0 

r-‘ ‘ f  J  j  :  i  i  •  ; 

Figure  C47.  Sample  run,  MOBILE_SINGI.E_QUANTITY 
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NEW  LINE  INPUT 


Purpose 

NEW_LINE_INPUT  is  the  program  that  generates  section  line  coordinates 
for  use  by  SURVEY  in  section  line  or  random  mode,  MANUAL_DATA_ENTRY , 
DIGITIZE_DEPTH_CHART ,  PLAN_PLOT,  CROSS_ SECTION AND_DREDGING,  TEMPLATE_MAKER , 

3D  MAKE,  and  others.  It  additionally  accepts  and  records  channel  coordinates, 
template  information,  and  general  comments. 

Input  files 

NAME. SITE 
Output  files 

NAME. SITE,  NAME. LINE 
External  devices 

Printer 

Modules  called 

INITMENU,  DRAWMENU,  MESSAGESTACK,  DRAWFORM,  CHANNEL_MFS SAGF ,  POLREC,  A2, 
GENERATE_LINES ,  SLANTED_LINES ,  EQUATI0N_FP0M_SL0PE_AND_1_P0INT_EQUATI0N_ 
PERPENDICULAR_TO_LINE,  GEN,  MINMAX,  SCALE_SCREEN ,  DRAWLINE,  FINDCOORDINATE , 
PLOT_CHANNEL_AND_SECTIONS,  DRAWCHANNEL,  DRAWCLBL,  CENTER_LINE_PLOT,  EXTRACT_ 
FROM_SITE_BUFFER,  INSERT_IN_SITEJBUFFER,  ONE_PORTION_SITE_BUFFER,  PATCH_ 
LENGTH,  ONE_PART_SITE_BUFFER,  GET_NAME_OF_FILE ,  DISTANCE_POINT_TO_A_LINE , 
EQUATI0N_FR0M_2_P0INTS,  CHANNEL_LINES ,  INTERSECTION,  PO I N T_ALONG_A_L I NE , 
EXTEND_LINE 
Theory  of  operation 

The  program  begins  by  initializing  some  of  the  pointers  used  by  the  form 
package.  Then  a  message  about  use  of  the  escape  key  is  written  to  device  6, 
the  screen.  Next,  the  file  form  is  displayed  by  calling  DRAWFORM  with  a 
series  of  arguments  beginning  wi  h  INFCOMMANDSTR.  If  the  operator  decides  to 
start  with  an  existing  .SITE  file  and  modify  it,  then  INFCHOS  would  have  the 
value  of  1.  If  thio  is  the  case,  GET  NAME  OF  FILE  Is  called,  the  desired  file 
is  opened  as  device  3,  and  the  site  information  is  read  in.  If  the  file  is 
not  confirmed,  but  rather  escaped,  then  escape  sequence  handling  is  begun  by 
calling  DRAWFORM  with  EXITCOMMANDSTK.  A  flag,  MODTFY_OLD,  is  set  true  if  a 
f ? le  is  read  in . 

The  next  section  of  code  deals  ’ith  entering  general  text  information 
for  archival  purposes.  If  MODIFY  OLD  is  true,  the  contents  of  the  form  are 
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filled  with  the  information  that  was  read  from  disk.  Then  from  one  to  five 
forms  (as  determined  by  inputs)  are  displayed  for  user  modification.  DRAWFORM 
is  called  with  SITECOMMANDSTR  as  the  first  argument.  Then  the  new  contents  of 
the  form  are  saved  over  original  contents  via  a  call  to  INSERT_IN_SITE_BUFFER. 

The  next  section  of  code  deals  with  entering  channel  coordinates  and 
template  information.  If  MODIFY  OLD  is  true,  the  contents  of  the  forms  are 
filled  with  the  information  that  was  read  from  disk.  Then  from  1  to  50  sets 
of  channel  coordinates  are  displayed  for  user  modification.  One  menu  and  one 
form  are  presented  for  each  coordinate  index.  The  information  concerning  the 
present  channel  index  is  displayed  by  calls  to  CHANNEL_MESSAGE.  The  menu  is 
displayed  by  calling  DRAWMENU  with  NEXTCHCOMMANDSTR  as  the  first  argument. 

The  menu  allows  choice  of  modify,  insert  before,  or  delete  the  present  channel 
iidex,  and  values  of  1,  2,  or  3,  respectively,  are  returned  for  the  argument 
CHITEMCHOS.  If  2  or  3  is  chosen,  the  channel  indices  from  present  on  are 
either  moved  back  or  forward  one  index.  DRAWFORM  is  then  called  with 
CHANCOMMANDSTR  as  the  first  argument.  The  new  form  contents  are  then  saved 
over  the  old  in  memory. 

Section  line  generation  is  the  subject  of  the  next  section  of  code. 

There  are  three  methods  of  defining  section  lines  and  each  uses  a  set  of 
forms.  The  method  and  disposition  cf  the  current  method  are  selected  in  a 
form  generated  by  a  call  to  DRAWFORM  with  a  first  argument  of  COMMANDSTRNLF. 
ITEMGR0UP1  has  a  value  on  return  of  1,  2,  or  3,  corresponding  to  Rectangular 
Method,  Nonrectangular  Method,  or  Channel  Based  Method,  respectively. 
ITF.MGROUP2.  has  a  value  on  return  of  1,  2,  or  3,  corresponding  to  modify  cur¬ 
rent  index,  delete  current  index,  or  insert  before  current  index,  respec¬ 
tively.  As  before,  the  form  Is  preloaded  from  data  read  from  disk  if 
M0DIFY_0LD  is  true  and  the  new  contents  replace  the  old  in  memory.  If 
ITEKGR0UP2  is  2  or  3,  the  group  indices  from  present  on  are  either  moved  back 
or  forward  one  index.  If  ITEMGR0UP1  is  1  (Rectangular),  DRAWFORM  is  called 
with  COMMANDSTR  as  the  first  argument,  MAINFORMPTR  as  the  second.  If 
ITEMGROL'Pl  is  2  (Nonrectangular),  DRAWFORM  is  called  twice.  The  first  call  is 
with  COMMANDSTR  as  tne  first  argument,  MAINFORMPTR  as  the  second;  the  second 
call  is  wich  SECOND SIR .  If  T TEMGR0UP 1  is  3  (Rectangular),  DRAWFORM  is  called 
with  CoMMA.VDSTR  as  the  first  argument,  CHANGRFORMPTR  as  the  second.  Section 
lines  are  generated  from  the  information  input  by  calls  to  subroutines.  By 
ordinal  value  of  ITEMGROL'Pl,  calls  are  made  to  (1)  GENERATE  LINES, 
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(2)  SLANTED_LINES ,  or  (3)  CHANNEL_L INES . 

The  channel  lines  entered  and  section  lines  computed  are  then  displayed. 
This  is  accomplished  by  calling  PLOT_CHANNEL_AND_SECTIONS.  A  disposition  form 
is  displayed  on  cop  of  the  channel  by  a  call  to  DRAWFORM  with  a  first  argument 
of  OUFCOMMANDSTR.  This  form  allows  selecting  the  output  file  name  and  what  is 
to  be  printed.  If  OUTFCHOS  equals  one,  data  are  to  be  saved;  if  PRINTCHOS  is 
not  equal  to  one,  then  printing  of  either  site(2),  line(3),  or  both  site  and 
line(4)  information  was  selected. 

The  flowchart  is  shown  in  Figure  C48,  and  a  sample  run  is  shown  in 
Figure  C49. 

Special  considerations 

The  left  and  right  side  of  the  channel  are  arbitrary,  but  must  be  con¬ 
sistent  throughout.  Also,  the  left  channel  side  coordinate  of  a  section  line 
should  be  entered  first,  then  the  right. 

The  channel  index  associated  with  a  section  line  must  correspond  to  the 
channel  section  in  which  the  line  falls.  A  group  of  section  lines  generated 
by  a  single  input  cannot  span  across  channel  sections,  because  the  channel 
index  is  input  for  the  whole  group  (if  this  is  a  problem,  the  line  file  may  be 
edited  to  correct  the  channel  index  numbers). 

Channel  based  is  the  easiest  way  to  generate  lines,  but  it  may  not 
associate  the  desired  station  number  with  the  line.  Often  it  is  desirable  to 
generate  lines  channel  based  to  get  the  coordinates  at  certain  points,  then  go 
back  and  regenerate  the  lines  using  rectangular  or  nonrectangular .  Channel 
index  numbers  when  using  rectangular  or  nonrectangular  input  methods  are 
defined  by  relationship  to  the  channel  coordinate  pairs. 

Channel  coordinates 

Assume  a  survey  with  channel  coordiante  pairs 

1.  A (L) , A(R) 

2.  B(L) , B(R) 

3.  C(L) ,C(R) 

4.  D(L),D(R) 

5.  E(r.),E(R) 

6.  F(L),F(R) 

7.  G(L), G(R) 

8.  H(L) ,H(R) 

9.  I (L) , I (R) 
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where 


A(L)  is  A(LE) , A(LN) 

A(R)  is  A(RE),A(RN) 

Channel  indices  are  determined  by  an  area  of  channel  plan  view  with  index 
number  of  first  channel  coordinate  pair  used  and  are  shown  as  1-8. 

Section  lines 

If  section  lines  are  superimposed  as  shown,  the  group  index  number 
should  be  as  follows: 


Section 

Channel 

Group 

No.  of  Lines 

Index  No. 

1 

2 

1 

2 

1 

1 

3 

2 

4 

4 

2 

6 

5 

2 

6 

6 

1 

7 
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IHCREHEXT  CROUP 
IHOCX 


RE HOME  THIS 
CROUP  OF  OHKL 
UflLUES 


Figure  C48.  (Sheet  2  of  5) 
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E 


Sheet  C48 .  (Sheet  3  of  5) 
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0I8PLAY  ADDITIONAL 
LIIE  INPUT  FCRH 


CALL  GENERATE 
LINES  SUBROUTINE 


1 _ 

- 1 

f 

CALL 

LINES 

9LAHTE0 

SUBROUTINE 

Figure  C48.  (Sheet  4  of  5) 
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******  ******  *  *  *  **■■*  *  *  *  *  *  *  *  *  V  *  *  :*.*.*  ****  *  *  *  *  *  *  * 

CODE  PETtJF’M  C OmF I Ptt5  h  FuRtt 
E S*, Hrt  •  N-jT  L'ljOE  E'^i.t-iPE  1  *->LL*jU'_'  E‘?* -Hr  lN»j 
*****************  **  *******'**'*************** 


TEXT  STRING 


NO  INPUT  FILE 


|l  INPUT  FILE  NONE  iMHPHiV 


TER  INPUT  FILE  NfltlE  AND  CONFIRM 


NEW  LINE.JNPUT-1 


CODE  RETURN  CCsNhlPMS  h  FukN 

EL'EmF'E  1  NU I  u’r.'DE  EuChFE  hLL'JUU  Eui-hP  Tf-k- 

NtmtnmttuHtttfmmttmtttttmtt 


fra 


!!  L  I  HE 


TEXT  STRING 


iTigrrm" 


TPTTTTr 


|!  LINE  U 

riA  ■  \y 

ji  LINE 

OE  H\  I 

l!  LINE  4 

I MC  Ru: 

'j  :  INF  * 

r*«*p- 1-» 

■tj'jpHFNI  - 


U'UTFf: 


MOPE  I  NFC  '  i'£: 


N  E  ul _ L  I  f’i  F  I M  Q  ij  T  -  2 


I’iTjt  wET/Pfi  '  7 11-  I  KM-.  _  k  ;yp 

iitHMMtMMtMtMitUf  tltMMtUtMIHH 


ra 


TEXT  STRING 


fFTTP  n.ru  !T-p  !•?■?•  !L"'  CTTrnrr 

rrr  'rrrr  rr?w<??iT 


Mi  rC'F  :■!>- 


rmmmmrzmTsmm 


'"'J L  l!-JF; 


r  -  3 


Figure  C49.  Sample  run,  NEW_UNE_INPUT 
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4444**4  *  4 i  4  * 4  4  4  4 4  4  4 4- 4  4  *  *  4  *  4 4 4- 4  4 *  *  4  * 4 4 4 4- 4 4  4  4 

CODE  PETUPn  COMF1  PMC  h  hC'RM 

EGChF'E  •  NOT  GUOE  E'tLhF’E  *  hLLuW';-  E‘:LhPINi.» 

4 4 4 4 1 4 4*4  4  44 4 4 4  4 4 4 4  4  4  4  4 4  4  4444  4  4  44  4  4  44  44  4*  4 4 


NEWJ_INE_INPL;T-4 


4  444  4  4  4  44  4  4  4  4  444  4  4  4  44  44  4  4:4  4  44  4  4  4  44-444  4  *  4  4  4  4 

CODE  RETURN  CONFIRMS  n  FOPM 

E'cLhPE  1  HUT  LODE  E'r>L. Hr E  >  hLLUIo  EOL Hr  I Nij 


Mil  REAL  NUITBER  iHHfllBMHi 

!! 

LEFT  CH  EhETIMG 

I725405  0250.  1 

!  LEFT  CH  NORTHING 

29 21 1  SO  0000 

F  T  oat  fH  Eh':-T[ug 

724SU  8125 

RIGHT  fH  NORTHING 

2,Zi3  J  E'6G  0000  ! 

BL  EhS TING 

r*25P‘?9  7750 

EL  MUPTHIMG 

2931094  0000 

•’  L  Eh:"- IMG 

7  j. *5  i  O' 0  0 £  ? S 

|  CL  NORTHING 

2931227  OO00 

'SIDE  left  pp-.f 

1 

SI  PE  LEFT  FUN 

7 

|  TIDE  RIGHT  RISE 

1 

TIDE  FIGHT  RUN 

7 

FPGjECT  OEriH 

SO  v  hJWuTt 

OUEROEPTH, 

j  oooo  ! 

" mMFI'TF  ‘ 

HATH  TNG  | 

i  MORE  lOOPDINhIES  hFTEP  THESE : 

NEW_l INE_INPuT -5 


4  4  4  4  4  4  44  f  44  4-  4-4  44  4  4  444  4-  4  t  ♦  ♦  ♦.44444  4  '?  f  » 

>_uDE  RE TOFU  i.  uMF  tPM’:-  h  FuF'M 
F  hF'E  *  M'  >r  i.uDE  Ev.kPE  hLLOMC  z  .  ;UG 

i  *  t  t  4  *  t  4  i  t  t  *  4  i  t  1  4  4  4'  4  4  *  *  t  *  4  4  i  4  4  4  *  i  4  4  i  4  4  *  *  *  *  t 


SELECT  NEXT  CHANNEL  COOED  I HATE  OPTION 


6L  EAST  - 
BL  NORTH 
CL  EAST 
CL  NORTH 
CH  LF  EAST 
CH  LF  NORTH 
CH  FT  EAST 
CH  FT  NORTH 
Ctf  LEF  RISE 
CH  LEFT  PIJN 
CH  PIG  RISE 
CH  RICH  RUN 
PPO-J  DEPTH 
OUEROEPTH 


U>  L  INF. 


Figure  C49. 


■ 725SJ3  188 
2930^P0  000 
725022  500 
2970670  O00 
725719  775 
2970586  000 
724725  625 
2920672  000 
1  000 
7  000 
1  000 
7  000 
50  000 
2  000 


INPUT  F. 
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NEW  LINE  I  MRU  T - 


MMJMMiMMllJttHJMHtUltiMMHttm 

\  OLE  •-  E T ' ;P ?  i  \f  1  Prvf.  h  F Ok  r: 

E  rL  m  ■  .;f.:E  c  .vhPE  •  »>*L  L'Jvi:  fF' I  M<j 

i  tHt  tt  UtitHtiiauJ  ditiHHHUiiHi'Ml 


ENTER  CHANNEL  COORDINATE  PftTR  NO 


.  ;rjf.  -i 


Figure  C49.  (Sheet  3  ot  6) 
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m  n  t  ♦  m  x  \  % 

\  i jDt  Pf  r  ORH  •'  ONF  I  RHG  m  FORM 

Ev.~FF  ■  NOT  CODE  EOChRE  ■■  HLLOWG  EGChRInG 

tit  1 1  m  t  u i ?  N i i i i t i i t  M jt it  tt  »  rlt  1 1 1  fitit  J 


!i  iTOmTV  ■  ■”i 

IHSgPTTJglTEETT^ 

4  HFe-PTF 

CCLCCT  IICUT  Cl  lill  II ICL 

coor:D  1 1  ihtc  orvr  i  oi  i 

BL  EAST 

725855  638 

BL  NORTH 

2938104 . 088 

CL  EAST 

724965  000 

V  * 

CL  NORTH 

2930233 . 008 

CH  LF  EAST 

725261.875 

• 

CH  LF  NORTH 

2930190  000 

CH  PT  EAST 

724668  1^5 

1 

CH  RT  NORTH 

2930276  008 

CH  LEF  RISE 

1 . 000 

CH  LEFT  RUN 

3  000 

CH  RIG  RISE 

'  1  000 

CH  RIGH  RUN 

3 . 000 

PPOJ  DEPTH 

50  000 

GUERDERTH 

2.000 

NEW  LINE_INPUT-  10 


'.OOE  RETURN  CONF  iPMS  h  F CRM 

F.  r-i. <-FE  NOT  CODE  ESChRE  •  hLLOUT  E'-'CAF'ING 

i  j *  j_yj  t ;  t *■  'It  t .t  *..*  till ;  t.l.t. <  1 


ftEAL  HUMBER 


LEFT  rw  Eh fT NO 
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J  RIGHT  CH  MOP  IN  1  Mi 
ji  EL  E Hr- TING 
!!  EL  NORTHING 

i’L  MOPThiNG 
i  :•  I GE  LL'RI  P  I  :  F 
•-II.-E  i.EFT  Pott 
l»  :•  I  I’E  >  I  GH  t  -  I  :.E 

Ij  •  iee  f  :  inr  c!i., 

!l  fpo.iF':  .-emu 
!]  O'.'ERGEF  TH 


,  oooo 

GOTO 104  0000 
0000 

GO TOG 7 7  0000 
i 


Sh  OOOO 
G  0000 
NOTHING 


Figure  C4('.  (Sheet  4  of  6) 
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I  M  M  I  t  M  M  M  M  M  M  t  t  M  M  I  M  M  .U  M  M  M  ♦  t 

'.O'Jti  P£  f'.'P^’  1  F'Mt  'rs  ^  ‘-.'FM 

EC-CmPF  rJfiT  i;  ':0E  E  SC  hPE  •  hLLOHS  ESC  wp  I  \  JG 

Utittitt  tJUttUJtUHiHUttHJiUUtJtlt 


[A  REAL  NUMBER 


I  SThTION  SThFT 

!  '-Tm7  Iun  I ML FEME NT 

}  E’  TEN:. 1 01  i  E-E  i  OnO  lHwHHEL  LEFT  S*IPE 

i  E':  TEti':  I  On  E'Ei  ONE'  CHhNNEL  FIGHT  SIDE 
!'  tEFhFmTiom 

ii  ':  T hF'T  i  NC  CHhNNEl.  COORDINhTE  IMDE  . 
jj  CHhNNEl  END  LINE;  Tu  INlLUOE 

j|  MuPE  OF L*UF hFTEF'  THIS’ 


1 00  0000 
1 00  0000 
LOO  0000 
l 

•;  ThPT 
.  ES 


ENTER  ALL  ITEMS  AND  CONFIRM 


NEW  LINE  INHUT- 15 


NNNNMM'tNNMNNNNI  tit  INMNTNM 

CODE  RETURN  CONFIRMS  h  FORM 

ESCmPE  HOT  CODE  ESChFE  *  hlLOUS  ESlhF ING 


F  EC  T  hNGULmP  MONPECThNGULhP 


SECTION  METHOD 

hC'TION  on  next  group 
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NEW  SPOT  INPUT 


Purpose 

NEW_SPOT_INPUT  accepts  coordinate  inputs  and  builds  a  .SPOT  file  for 
input  to  the  FIND_SPOT  survey  program. 

Input  files 

NAME. SPOT 
Output  files 

NAME. SPOT 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU ,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  GET_NAME_OF_FILE , 
CHANNEL_MESSAGE 
Theory  of  operation 

NEW_SPOT_INPUT  begins  by  displaying  an  input  file  form.  It  then  reads 
in  the  spot  coordinates  to  be  modified  (if  any)  and  loops  accepting  new  or 
changed  coordinates.  The  flowchart  is  shown  in  Figure  C50,  and  a  sample  run 
is  shown  in  Figure  C51. 
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Figure  C50.  Flowchart, 
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Figure  C51.  Sample  run,  NEW  SPOT  INPUT  (Continued) 
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PILOT 


Purpose 

PILOT  is  one  of  the  tasks  spawned  by  SURVEY.  It  takes  distance  along 
the  line  and  offset  information  from  the  common  memory  area  and  sends  it  out 
over  the  modem  port  to  the  pilot  indicator  computer. 

Input  files 
NONE 

Output  files 
NONE 

External  devices 

Pilot  Indicator  Computer 
Modules  called 

CunVASCI,  INIMODEM,  WRMODEM,  TERMMO,  PROBLEM,  A2 
Theory  of  operation 

PILOT  begins  by  makins  the  modem  connection,  then  waits  for  a  flag  from 
PLOT_SCREEN  before  proceeding.  It  then  loops  until  the  death  flag  is 
detected,  sending  out  line  coordinates  if  the  new  line  flag  is  set  or  distance 
along  the  line  versus  depth  if  not.  The  flowchart  is  shown  in  Figure  C52. 
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PLAN  VIEW  DESCRIPTION 


Purpose 

PLAN_VIEW  DESCRIPTION  is  a  form-driven  program  to  provide  easy  input  of 
plotting  parameters  required  L»y  PLAN_PLOT  a..d  CONTOUR_PLOT. 

Input  files 

NAME . PLAN 
Output  files 

NAME. PLAN 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  SET_LEGEND, 
GET_LEGEND ,  GET_NAME_OF_FILE 
Theory  of  operation 

PLAN_VIEW  DESCRIPTION  displays  a  file  form  and  reads  in  the  present  file 
description  (if  any).  It  then  displays  a  series  of  forms  to  allow  changing 
present  parameters.  Then  it  writes  the  changed  parameters  out  to  the  selected 
file.  The  flowchart  is  shown  in  Figure  C53,  and  a  sample  run  is  shown  in 
Figure  C54. 
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PLOT  FEATURES 


Purpose 

PLOT_FEATURES  is  a  program  to  plot  a  particular  .FEAT  file  scaled  by  the 
input  information. 

Input  files 

NAME. FEAT,  NAME. LABE,  FEATURES,  LABELS 
Output  files 
NONE 

External  devices 
Plotter 

Modules  called 

INITMENU,  PLOTSC ,  DRAWMENU,  DRAWFORM,  GET_NAME_OF_FILE ,  POLREC,  A2, 
PLOTROT,  TRANSPOSE_ORIGIN,  SYMBOLROT,  PROBLEM,  OA 
Theory  of  operation 

PLOT_FEATURES  begins  by  displaying  a  file  form  and  accepting  the  .FEAT 
file  name  for  plotting.  It  then  accepts  plot  parameters  from  key.  Then  it 
reads  in  the  .FEAT  file  and  plots  the  features.  Next  it  reads  in  the  the 
names  of  other  .FEAT  files  from  the  file  FEATURES  and  plots  the  features  in 
the  .LABE  file  and  plots  the  labels.  Finally  It  reads  in  the  names  of  other 
.LABE  from  the  file  LABELS  and  plots  the  labels  In  these  files.  The  flowchart 
is  shown  in  Figure  C55,  and  a  sample  run  is  shown  in  Figure  C56. 

Special  considerations 

Delete  the  FEATURES  and  LABELS  files  (or  clear  their  contents)  when  not 


Figure  C55.  Flowchart, 
PLOT_FEATURES 
(Continued) 
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Figure  C56.  Sample  run,  PLOT_FEATURES 
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PLOT  LETTERS 


Purpose 

PLOT_LETTERS  is  a  program  to  plot  .LETT  files  listed  in  the  file 
LETTERS. 

Input  files 

NAME. LETT,  LETTERS,  OTHER. LETT  files 
Output  files 
NONE 

External  devices 
Plotter 

Modules  called 

INITMENU,  DRAWMENU,  DRAWFORM,  GET_NAME_OF_FILE ,  PLOTROT, 

TRANSPOSE_ ORIGIN,  SYMBOLROT,  PROBLEM 
Theory  of  operation 

PLOT_LETTERS  begins  by  displaying  a  file  form  and  accepting  the  .LETT 
file  name  for  plotting.  Then  it  reads  in  the  .LETT  file  and  plots  the  lines 
and  letters  defined.  Next  it  reads  in  the  the  names  of  other  .LETT  files  from 
the  file  LETTERS  and  plots  the  lines  and  letters  in  the  .LETT  file.  The  flow¬ 
chart  is  shown  in  Figure  C57,  and  a  sample  run  is  shown  in  Figure  C58. 

Special  Considerations 

Delete  the  LETTERS  file  (or  clear  its  contents)  when  not  in  use. 
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Sample  run,  PLOT  LETTERS 


(Continued) 
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PLOT_LETTERS_DESCRIPTION 

Purpose 

PLOT  LETTERS  DESCRIPTION  provides  a  friendly  environment  for  entering 
information  necessary  for  creating  plots  of  manually  entered  line  or  text 
data.  Its  output  file  serves  as  input  to  PLOT_LETTERS  and  to  the  PLAN_VIEW 
program.  Therefore  blocks  of  lines  and  letters,  such  as  legends  or  indices 
may  be  created,  modified,  and  plotted  by  the  computer. 

Input  files 

NAME. LETT 
Output  files 

NAME. LETT 
External  devices 
NONE 

Modules  called 

PROBLEM,  INITMENU,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  G ET_NAME_OF_FILE, 
INSERT_IN_SITE_BUFFER,  ONE_PORTION_SITE_BUFFER,  EXTRACT_FR0M_S1TE_BUFFER , 
TEXT_MESSAGE ,  CHANNEL_MESSAGE 
Theory  of  operation 

PLOT_LETTERS_DESCRIPTION  reads  in  current  line/letter  parameters,  fills 
forms  with  these  values,  and  displays  the  forms.  If  a  nonexistant  file  name 
is  entered,  a  new  .LETT  file  is  created.  The  contents  of  this  new  file  are 
defined  by  filing  in  forms.  To  modify  the  file,  the  program  Is  run  again  with 
the  file  name  entered.  It  then  accepts  changes  and  outputs  a  .LETT  file.  A 
.LETT  file  would  normally  define  a  text/line  graphical  block.  The  block  is 
rotated  around  a  point  corresponding  to  0,0  in.  of  block  units  at  some  x,y 
position  on  the  paper.  The  former  (0,0)  is  assumed;  the  latter  (x,y)  is 
entered.  Only  one  line  of  text  may  be  entered  at  a  time  (up  to  256  characters 
long)  .  As  each  line  is  confirmed,  the  position  of  the  default  block  for  the 
next  line  is  calculated  as  if  a  carriage  return,  line  feed  had  been  entered. 
This  simplifies  entering  multiple  lines  of  text.  The  intrablock  letter  rota¬ 
tion  angle  would  normally  be  0,  90,  180,  or  270  deg  (although  any  angle  is 
acceptable);  the  block  rotation  angle  might  be  any  angle  and  sets  the  overall 
block  rotation.  The  flowchart  is  shown  in  Figure  C59,  and  a  sample  run  is 
shown  in  Figure  C60. 
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Figure  C60.  Sample  run,  PLOT_LETTERS_DESCRIPTION 
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Figure  C60.  (Sheet  2  of  5) 
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Figure  C60.  (Sheet  4  of  5) 
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Figure  C60.  (Sheet  5  of  5) 
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PLOT  PLOTTER 


Purpose 

PLOT_PLOTTER  is  a  task  spawned  by  the  SURVEY  program.  Its  purpose  is  to 
display  the  boat's  current  position  and  current  depths  in  plan  view  on  the 
plotter. 

Input  files 

NONE  (parameters  from  .PLAN  are  passed  through  system  common) 

Output  files 
NONE 

External  devices 
Plotter 

Modules  called 

CASCII,  POLREC,  A2 ,  PROBLEM,  PLOTROT,  TRANSPOSE_ORIGIN,  SYMBOLROT 
Theory  of  operation 

PLOT_PLOTTER  begins  by  waiting  for  the  operator  to  align  the  paper  if 
manual  alignment  was  selected  in  the  .PLAN  file.  It  then  does  the  rotation 
and  scaling  selected  in  the  .PLAN  file.  It  plots  the  channel  lines,  center 
line,  base  line,  section  lines,  station  numbers,  and  north  arrow.  It  then 
picks  up  the  proper  pen  for  depth  plotting  and  waits  for  PLOT_SCREEN  to  set 
the  continue  flag.  At  this  point  the  pen  follows  the  current  boat  position  on 
the  plot.  If  data  are  being  saved,  depths  are  printed  (logic  assures  depths 
are  not  overprinted  even  though  many  more  depths  are  saved  than  plotted) . 

The  flowchart  is  shown  in  Figure  C61. 

Special  considerations 

A  .PLAN  file  should  be  created  in  the  office  prior  to  going  to  the  site. 
Otherwise,  PLAN  VIEW  DESCRIPTOR  must  be  run  at  the  site. 
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PLOT  PLOTTER  LOUISVILLE 


Purpose 

PLOT_PLOTTER_LOUISVILLE  is  a  task  spawned  by  the  SURVEY  program.  Its 
purpose  is  to  display  the  boat's  current  positions  and  current  depths  in  plan 
view  on  the  plotter. 

Input  files 

NONE  (plot  parameters  are  passed  through  system  common) 

Output  files 

BAR_ID.EQUI  (where  BAR_ID  is  the  bar  number) 

External  devices 

Plotter 

Modules  called 

CASCII,  POLREC,  A2 ,  PROBLEM 
Theory  of  operation 

PLOT_PLOTTER_LOUISvILLE  begins  by  plotting  legend  information  about  buoy 
symbol/colors,  transponder  symbol/colors,  pool,  bar,  etc.  It  then  waits  for 
the  operator  to  position  the  pen  on  the  paper  and  select  transponder  B's  loca¬ 
tion.  Transponder  B's  symbol  is  then  plotted  at  that  point.  Separation 
between  transponder  A  and  B  was  enter0'1  a  form  displayed  by  CONFIGURE,  but 
azimuth  is  presently  unknown.  Therefore,  the  operator  then  positions  the  pen 
in  the  relative  azimuth  of  transponder  A  and  enters  a  return.  The  task 
adjusts  the  position  by  the  scaled  separation  and  plots  the  symbol  for  trans¬ 
ponder  A.  It  then  recomputes  transponder  positions  and  writes  these  out  to 
the  BAR_NO . EQUI  file.  Then  it  waits  until  ?LOT_SCREEN_LOUISVILLE  sets  the 
continue  flag.  At  this  point  it  loops  moving  the  pen  to  follow  the  boat  posi¬ 
tion.  If  a  mark  is  entered,  the  appropriate  mark  symbol  is  plotted  at  the 
current  boat  position.  If  saving  data  is  enabled,  depths  are  plotted.  Logic 
assures  depths  are  not  overprinted  even  though  many  more  depths  are  collected 
than  are  plotted.  The  flowchart  is  shown  in  Figure  C62. 
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Figure  C62.  Flowchart, 
PLOT  PLOTTER  LOUISVILLE 


PLOT  SCREEN 


Purpose 

PLOT_SCREEN  is  a  task  spawned  by  the  SURVEY  program.  It  provides  the 
screen  and  keyboard  interface  during  surveying. 

Input  files 

NONE  (parameters  are  passed  through  system  common) 

Output  files 

NAME. 0001  (where  .0001  is  the  line  number) 

NAME. MOO 1  (where  001  is  the  mark  number) 

NAME.D001  (where  001  is  the  tide  number) 

External  devices 
NONE 

Modules  called 

ASCI,  UPDATESCREEN,  POLREu,  A2 ,  PROBLEM,  INISOUND,  WRSOUND,  TERMSOUND 
Theory  of  operation 

PLOT_SCREEN  begins  by  mapping  to  common  memory  area  and  initializing  to 
the  first  line.  It  then  creates  the  initial  screen  display  of  cross  and/or 
plan  view  and  current  reading.  Next  it  loops,  testing  to  see  if  a  key  has 
been  pressed  and  updating  the  screen.  If  a  key  has  been  pressed,  it  carries 
out  the  appropriate  action.  At  the  end  of  a  line  it  updates  the  screen  to  the 
next  line,  then  it  writes  the  data  to  disk.  The  flowchart  is  shown  in 
Figure  C63. 

Special  considerations 

Marks  or  tides  entered  while  saving  data  to  memory  are  not  written  to 
disk  until  the  end  of  line;  so  it  is  faster  to  collect  marks  separately  from 
running  lines  although  either  way  works. 
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Figure  C63.  (Sheet  5  of  5) 


Cl  55 


PLOT  SCREENIMAGE 


Purpose 

PLOT_SCREENIMAGE  reads  a  list  of  screen  images  and  plot  parameters  from 
SCREENIMAGE  and  plots  the  associated  images.  It  is  a  follow  up  to  FLAN_PLOT 
and  is  part  of  the  CAM  package. 

Input  files 

SCREENIMAGE,  P0S2,  NAME~5CREENIMAGE~ 

Output  files 
NONE 

External  devices 
Plotter 

Modules  called 

PROBLEM,  ON,  LINEPLOT,  SET,  PLOTROT,  TRANSPOSE_ORIGIN 
Theory  of  operation 

PLOT_SCREENIMAGE  gets  file  names  from  SCREENIMAGE.  It  takes  these 
raster  scan  files  and  converts  them  to  vector  plotter  commands.  Each  dot  is 
produced  by  multiple  passes  (depending  on  the  plot  scale)  of  short  lines.  The 
flowchart  is  shown  in  Figure  C64. 


Figure  C64.  Flowchart, 
PLOT  SCREEN IMAGE 
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PLOT  SCREEN  LOUISVILLE 


Purpose 

PLOT_SCREEN_LOUISVILLE  is  a  task  spawned  by  SURVEY  that  handles  the 
operator  interface  for  the  Louisville-style  survey. 

Input  files 

NONE  (parameters  passed  through  system  common) 

Output  files 

NAME. 0001  (where  .0001  is  the  line  number) 

NAME.M001  (where  001  is  the  mark  number) 

NAME.D001  (where  001  is  the  tide  number) 

External  devices 
NONE 

Modules  called 

ASCI,  POLREC,  A2 ,  PROBLEM,  INISOUND,  WRSOUND,  TERMSD,  UPDATESCREEN 
Theory  of  operation 

PLOT_SCREEN_LOUISVILLE  begins  by  initializing  to  the  first  line  and  dis¬ 
playing  that  line.  It  then  sets  the  continue  flag  so  that  the  other  tasks  can 
continue.  Then  it  loops  checking  to  see  if  a  key  has  been  pressed  and  react¬ 
ing  accordingly  while  updating  the  screen.  If  the  line  is  finished  or  a  mark 
has  been  entered,  data  are  saved  to  disk.  The  flowchart  is  shown  in 
Figure  C65. 
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Figure  C65.  Flowchart, 
PLOT_SCREEN_LOUISVILLE 
(Sheet  1  of  5) 
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CHANGE  SCALE 
SELECTOR  TO 
HEXT  SCALE 


PRINT 


Purpose 

PRINT  is  one  of  the  tasks  which  may  be  spawned  by  the  SURVEY  program. 

It  prints  time,  depth,  easting,  northing,  distance  along  line,  and  offset  at 

^  a  r-' '  rj  1  ont-flro/1  intn  f'nNFTfMTRF  1  c  form 

Input  Files 

NONE  (parameters  are  passed  through  system  common) 

Output  Files 
NONE 

External  devices 
NONE 

Modules  called 
PROBLEM 

Theory  of  operation 

PRINT  begins  by  initialize  0  the  printer  then  waits  for  the  continue 
flag  from  PLOT_SCREEN.  It  then  loops,  printing  the  latest  data  acquired.  If 
the  line  number  has  changed  since  the  last  pass,  the  line  number  is  printed  as 
a  header.  The  flowchart  is  shown  in  Figure  C66. 
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Figure  C66.  Flowchart,  PR  •'.NT 
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PRINT  DATA 


Purpose 

PRINT  DATA  prints  the  acquired  survey  data  in  raw  form:  (1)  time  versus 
depth  and  (2)  time  versus  position.  It  is  useful  for  resolving  problems  and 
is  not  riC^u.dl>  used,  aw  the  graphical  presentations  are  normally  preferred. 
Input  files 

NAME. 0001  (where  .0001  is  the  line  number) 

Output  files 
NONE 

External  devices 
Printer 

Modules  called 

PROBLEM,  INITMEmJ,  DRAWMENU,  MESSAGESTACK ,  DRAWFORM,  GET_NAME_0F_FILE 
Theory  of  operation 

PRINT_DATA  displays  a  file  form  to  get  cue  site  name.  It  then  loops 
through  the  data  lines  collected  printing  the  data  in  raw  form:  time  versus 
reading.  The  flowchart  is  shown  in  Figure  C67,  and  a  sample  run  is  shown  in 
Figure  CG8. 
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Figure  C67.  Flowchart, 
PRINT  DATA 
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Figure  C.68.  Sample  run,  PR1NT_DATA 
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PRINTJ1ARKS-1 
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Figure  C70.  Sample  run,  PRINT_MARKS 
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RANDOM 


Purpose 

RANDOM  is  a  task  spawned  by  the  SURVEY  program.  It  provides  the  screen 
and  keyboard  interface  during  surveying. 

Input  files 

NONE  (parameters  are  passed  through  system  common) 

Output  files 

NAME. 0001  (where  .0001  is  the  line  number) 

NAME.M001  (where  001  is  the  mark  number) 

NAME.D001  (where  001  is  the  tide  number) 

External  devices 

NONE 

Modules  called 

ASCI,  UPDATESCREEN,  POLREC,  A2 ,  PROBLEM,  INISOUND,  WRSOUND,  TERMSOUND 
Theory  of  operation 

RANDOM  begins  by  mapping  to  common  memory  area  and  initializing  to  the 
first  line.  It  then  asks  if  the  present  channel  and  section  coordinate  infor¬ 
mation  is  to  be  used  or  discarded.  Next  it  displays  a  number  of  options  in¬ 
cluding  going  into  run  or  channel  marking  mode.  If  one  of  these  two  options 

is  chosen,  it  creates  the  initial  screen  display  of  cross  and/or  plan  view  and 

current  reading.  Next  it  loops,  testing  to  see  if  a  key  has  been  pressed  and 
updating  the  screen.  If  a  key  has  been  pressed,  it  carries  out  the  appropri¬ 
ate  action.  At  the  end  of  a  line  it  updates  the  screen  to  the  next  line,  then 
it  writes  the  data  to  disk. 

RANDOM  survey  has  two  major  modes:  (1)  RUN  and  (2)  CHANNEL.  RUN  mode 
is  used  to 

a.  Establish  a  reference  line  using  Y  to  mark  left  side  of  channel 

start  of  line,  and  Z  to  mark  right  side  of  channel  end  of  line 

b.  Run  a  generated  section  line  (same  as  with  section  line) 

c .  Run  randomly 

CHANNEL  mode  is  used  to  establish  new  channel  coordinates  or  change  old  ones. 

A  line  will  be  displayed  on  the  screen  only  and  pilot  guidance  will  be  dis¬ 
played  when  running  a  generated  line.  Channel  mode  and  running  randomly  must 
be  done  by  visual  surveillance. 

Key  options  for  RUN  mode  are  the  same  as  with  section  line  surveys 
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except  Q  returns  to  the  mode  select  menu  rather  than  quitting  and  ¥  and  Z  have 
been  added. 

Key  options  for  CHANNEL  mode  are: 

L  Marks  left  side  of  channel 
R  Marks  right  side  of  channel 
C  Marks  center  line  of  channel 
B  Marks  base  line  of  channel 

N  Saves  present  channel  coordinate  pairs  and  advances  to  next 
channel  index 

J  Jumps  back  to  previous  channel  index  and  redoes  it 

Q  Returns  to  mode  select  menu 

E  Ends  index 

When  in  RUN  mode  the  current  section  line  number  is  shown  in  the  upper 
right  corner;  when  in  CHANNEL  the  current  channel  index  number  is  shown  in  the 
upper  right  corner. 

When  finished,  Q  must  be  entered  from  the  mode  select  menu  to  quit  the 
program.  If  the  program  is  not  terminated  in  this  manner,  the  section  line 
file  (.LINE)  will  not  be  updated. 

The  flowchart  is  shown  in  Figure  C71,  and  a  typical  run  is  shown  in 
Figure  C72. 
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Figure  C71.  Flowchart,  RANDOM  (Sheet  1  of  8) 
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Figure  C71.  (Sheet  2  of  8) 
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Figure  C71.  (Sheet  4  of  8) 
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Typical  run? 

Enter  N 
N 

to  start  a  new 
Go  to  run  mode 

Use  Y  and  Z  to  establish  reference 
Use  Q  to  quit 
Go  to  CHANNEL  mode 

Use  L  and  R  to  establish  1st  channel  index 
Use  N  to  increment 
Use  L  and  R  to  establish  2nd  index 
Use  E  to  end 
Use  Q  to  quit 
Generate  section  lines 
Go  to  RUN  mode  and  run  lines 

Use  Q  to  quit  RUN  mode  when  last  line  has  been  completed 
Use  Q  option  to  end  program 


Typical  pick  up  where  left  off? 
Enter  Y 
Y 

and  continue  as  before 


Typical  Random? 

Enter  N 
N 

Go  to  CHANNEL  mode  and  mark  channel 

Go  to  RUN  mode  and  use  S  and  E  keys  to  collect  data 

Use  Q  to  quit  RUN  mode 

Use  Q  option  to  quit  program 

Figure  C72.  Typical  run,  RANDOM 
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RANGE  DEVICE 

Purpose 

There  are  a  number  of  range  equipment  programs  and  cue  simulation  pro¬ 
gram.  One  of  these  programs  runs  in  conjunction  with  the  survey  program, 
determined  by  the  positioning  equipment  used.  These  programs  collect  ranges 
and/or  azimuths,  convert  the  readings  to  absolute  position  and  relative-to- 
the-survey-line  position,  determine  beginning  and  end  of  automatic  data  col¬ 
lection,  calculate  boat  speed,  and  provide  position  information  to  other 
tasks . 

Input  files 

NONE  (data  are  passed  through  a  common  block  of  memory) 

Output  files 

NONE  (data  are  passed  through  a  common  block  of  memory) 

Equipment  required 

Supported  range  equipment  using  RS232  interface 
Modules  called 

TIME_INTO_TEST,  OFFDIST ,  POSITRR  OR  POSITRA,  POLREC,  A2 ,  DEL_NORTE 
(range  equipment  specific),  INISER,  RDSERI ,  WRSERI,  TERMSE,  PROBLEM 
Theory  of  operation 

The  range  equipment  program  is  spawned  by  SURVEY,  does  some  initializa¬ 
tion,  and  waits  for  PLOT  SCREEN  to  set  a  flag  before  proceeding  (PLOT  SCREEN 
is  the  last  task  spawned  so  all  are  memory  resident  at  this  time).  It  then 
begins  a  tight  loop  of  acquiring  ranges,  calculating  position,  checking 
distance-along-line  to  see  if  time  to  trigger  an  event,  and  putting  acquired 
data  in  the  output  buffer.  It  terminates  when  PLOT_SCREEN  sets  the  death 
flag.  The  flowchart  is  shown  in  Figure  C73. 
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Figure  C73.  Flowchart 
RANGE  DEVICE 


RANGE  SIMULATE 


Purpose 

RANGE_SIMULATE  is  a  task  in  the  survey  package  spawned  by  the  task 
SURVEY.  It  is  used  to  provide  simulated  position  data  when  range  equipment  is 
not  attached. 

Input  files 

NONE  (data  are  passed  through  system  common  memory) 

Output  files 

NONE  (data  are  passed  through  system  common  memory) 

External  devices 
NONE 

Modules  called 

TIME__INTO_TEST,  DISTOFF,  POLREC,  A2 ,  PROBLEM 
Theory  of  Operation 

RANGE_SIMULATE  initializes  parameters  then  waits  for  PLOT_SCREEN  to  set 
a  flag  indicating  all  tasks  are  running.  It  then  begins  a  loop  generating  a 
point  approximately  every  0.8  sec.  The  program  generates  pseudo-absolute  and 
relative  position,  and  checks  to  see  if  it  is  time  to  trigger  an  event  based 
on  distance  along  the  line.  It  then  reloops  until  the  death  flag  is  set. 

The  flowchart  is  shown  in  Figure  C74. 
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Figure  C7A.  Flowchart,  RANGE_S IMULATE 
(Continued) 
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Figure  C74.  (Concluded) 
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SURVEY 


* 


Purpose 

SURVEY  is  a  survey  task  designed  to  start  up  the  tasks  needed  to  fulfill 
the  desired  survey.  It  must  first  determine  the  survey  parameters  by  spawning 
a  configuration  (input/output)  task.  Then  it  spawns  the  needed  tasks  for  the 
type  survey  specified. 

Input  files 

NONE  (uses  common  block  of  memory  for  data  passing) 

Output  files 

NONE  (uses  common  block  of  memory  for  data  passing) 

External  devices 

NONE 

Modules  called 

PROBLEM 

Theory  of  operation 

SURVEY  begins  by  getting  its  own  process  identification  number  from  the 
system.  Then  it  sets  its  priority  to  238.  It  creates  two  system  common 
blocks  of  memory  through  which  tasks  can  communicate.  It  then  spawns  its  I/O 
task  CONFIGURE  and  waits  for  CONFIGURE  to  complete  its  job  and  die.  A  defini¬ 
tion  of  the  survey  to  be  run  is  now  available  in  the  common  blocks  of  memory. 
Based  on  this  information  various  tasks  are  spawned.  A  depth  task  is  spawned 
at  priority  239.  A  range  task  is  spawned  at  priority  240.  The  pilot  indica¬ 
tor  task  may  be  spawned  at  priority  241.  The  printing  task  may  be  spawned  at 
priority  242.  A  plotting  task  may  be  spawned  at  priority  244.  A  screen 
graphic  and  operator  interface  task  is  spawned  at  priority  245.  The  task  then 
loops  waiting  for  the  death  flag  to  be  set.  It  then  delays  for  5  sec  before 
dying  as  it  must  be  the  last  task  to  die  since  it  created  the  common  memory 
area  (otherwise,  the  system  would  crash).  The  flowchart  is  shown  in 
Figure  C75,  and  a  sample  run  is  shown  in  Figure  C76. 
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Figure  C75.  Flowchart,  SURVEY 
(Sheet  1  of  3) 


Figure  C75.  (Sheet  2  of  3) 
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CREATE  PROCESS 
PEOT. SCREEN 
LOU1SW1LLE  AT 
PRIORITY  253 


CREATE  PROCESS 
PEOT_SCREEH  AT 
PRIORITY  255 


ENTER  SURUEV  INFORMATION  hHD  CONFIRM 


SURVEY-1 


lEF'TH  CHANGE  IN  FEET 


POSITION  AT  LEAST  10  0000 
POSITION  hT  LEAST  20  0000 
DEPTH  AT  LEhST  1  0000 
I  DEPTH  hT  LEhST  5  0000 
|  DEPTH  hT  LEhST  I  1  " 


ENTER  OhTh  SANE  RATE  FhRhMETEPS  AND  CONFIRM 


SURVEY-2 


NhME  OF  'SUPAEV  SITE 


ENTER  INPUT  FILE  NAME  AND  CONFIRM 


SURVEY-3 


Figure  C76.  Sample  run,  SURVEY 
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APPENDIX  D:  FILE  AND  MEMORY  STRUCTURE 


Main  Run-Time  Common  Memory  Block  Layout  (Buff) 


ENTRIES  OF  4  BYTES  EACH  FOR: 

1.  LIFE( 1 ) /DEATH (0)  FLAG  FOR  ALL  PROCESSES  (Tasks) 

2.  NEW  LINE  YES (1 ) /N0(0)  FLAG 

3.  NEED  NEW  COORDINATE  YES(1)/N0(0)  FLAG 

4.  SAVING  DATA  YES(I)/N0(0)  FLAG 

5.  AUTO  START/STOP  ENABLE(1)/DISABlE(0)  FLAG 

6.  NOT  USED 

7.  REAL  SURVEY (0) /SIMULATION (1)  FLAG 

8.  NOT  USED 

9.  BUFFER  POINTER  TO  NEXT  AVAILABLE  INDEX  (integer) 

10.  NOT  USED 

11.  LATEST  DEPTH  (FLOATING  POINT) 

12.  LATEST  EASTING  (FLOATING  POINT) 

13.  LATEST  NORTHING  (FLOATING  POINT) 

14.  LATEST  DISTANCE  ALONG  LINE  (FLOATING  POINT) 

15.  LATEST  OFFSET  FROM  LINE  (FLOATING  POINT) 

16.  LENGTH  OF  SECTION  LINE  (FLOATING  POINT) 

17.  PROJECT  DEPTH  (FLOATING  POINT) 

18.  NOT  USED 

19.  SLOPE  OF  LEFT  SIDE  OF  CHANNEL  (FLOATING  POINT) 

20.  ALLOWED  OVERDREDGE  (FLOATING  POINT) 

21.  NOT  USED 

22.  NOT  USED 

23.  EASTING  OF  START  OF  LINE  (FLOATING  POINT) 

24.  NORTHING  OF  START  OF  LINE  (FLOATING  POINT) 

25.  EASTING  OF  END  OF  LINE  (FLOATING  POINT) 

26.  NORTHING  OF  END  OF  LINE  (FLOATING  POINT) 

27.  ANGLE  OF  SURVEY  LINE  (FLOATING  POINT) 

28.  NOT  USED 

29.  NOT  USED 

30.  NOT  USED 

31.  BOAT  ANTENNA  HEIGHT  FROM  REFERENCE  (FLOATING  POINT) 

32.  DATE  PART  1  GRID  Format 

33.  DATE  PART  2  GRID  Format 

34.  DATE  PART  3  GRID  Format 

35.  NOT  USED 

36.  LINE  DIRECTION  NORMAL (0) /REVERSE (1 )  FLAG 

37.  NOT  USED 

38.  BOAT  VELOCITY  (FLOATING  POINT) 

39.  RELATIVE  TIME  OF  LATEST  POSITION  SINCE  START  OF  PRESENT  LINE 
(integer) 

40.  MARK  EASTING  (FLOATING  POINT) 

41.  MARK  NORTHING  (FLOATING  POINT) 

42.  MARK  DEPTH  (FLOATING  POINT) 

43.  RELATIVE  TIME  SINCE  START  OF  PRESENT  LINE  INTEGER 

44.  NOT  USED 

45.  NOT  USED 

46.  NOT  USED 

47.  NOT  USED 

48.  NOT  USED 
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49.  NOT  USED 

50.  NOT  USED 

51.  NOT  USED 

52.  SIMULATION  POINT  COUNTER  (integer) 

53.  SIMULATION  DISTANCE  ALONG  THE  LINE  INCREMENT  (FLOATING  POINT) 

54.  GEOMETRY  FLAG  GOOD (0) /BAD ( 1) /POOR(2) 

55.  HEIGHT  RED  TRANSPONDER  (FLOATING  POINT) 

56.  EASTING  RED  TRANSPONDER  (FLOATING  POINT) 

57.  NORTHING  RED  TRANSPONDER  (FLOATING  POINT) 

58.  HEIGHT  GREEN  TRANSPONDER  (FLOATING  POINT) 

59.  EASTING  GREEN  TRANSPONDER  (FLOATING  POINT) 

60.  NORTHING  GREEN  TRANSPONDER  (FLOATING  POINT) 

61.  SIDE  OF  LINE  BOAT  IS  ON  FLAG 

62.  ALL  TASKS  STARTED  YES  PROCEED ( 1 ) /NO  WAIT(O)  FLAG 

63.  DEPTH  CLOSEST  IN  TIME  TO  LATEST  POSITION  (FLOATING  POINT) 

64.  MARK  READY  TO  BE  SAVED  N0(0)/YES(1)  FLAG 

65.  RANGE  READY  TO  BE  SAVED  N0(0)/YES(1)  FLAG 

66.  TIDE  ENTRY  READY  TO  BE  SAVED  N0(0)/YES(1)  FLAG 

67.  TIDE  ENTRY  (FLOATING  POINT) 

68.  RANGE_TYPE  +  RELATIVE  TIME  (Concatenated  integer) 

69.  DISK  I/O  IN  PROGRESS  YES(1)/N0(0)  FLAG 

70.  FIX  MARKS  TO  DEPTH  CHART  YES(1)/N0(0)  FLAG 

71.  FIX  MARK  INTERVAL  (FLOATING  POINT) 

72.  FIX  MARK  WIDTH  tkj  DEPTH  U~-TE  INTERVALS  (Integer) 

73.  CONFIGURATION  PROGRAM  RUNNING  YES(0)/N0(l)  FLAG 

74.  PILOT  INDICATOR  YES(0)/N0(1)  FLAG 

75.  RANGE  DEVICE  IDENTIFIER  (integer) 

76.  DEPTH  DEVICE  IDENTIFIER  (integer) 

77.  SURVEY  TYPE  IDENTIFIER  (integer) 

78.  SECONDS/DEPTH  READING  SAVED  (FLOATING  POINT) 

79.  SECONDS/RANGE  READING  SAVED  (FLOATING  POINT) 

80.  SAVE  ALL  POINTS  YES(0)/N0(l)  FLAG 

81.  POOL  ELEVATION  (FLOATING  POINT) 

82.  PLOT  SCALE  (FLOATING  POINT) 

83.  DELTA  TIME  IN  SECONDS  BETWEEN  PRINTING  (FLOATING  POINT) 

84.  CURRENT  LINE  NUMBER  (integer) 

85.  PLOT  VIEW  NONE  (0)/CROSS  SECTION ( 1) /PLAN(2)  FLAG 

86.  1st  CUBIC  TRANSPONDER  DISPLAY  POSITION  (integer) 

87.  2nd  CUBIC  TRANSPONDER  DISPLAY  POSITION  (integer) 

88.  RANGE  FILTER  DISABLED (0) /ENABLED ( 1 )  FLAG 

89.  CUBIC  TEN  THOUSANDS  DIGIT  FIRST  TRANSPONDER  (integer) 

90.  CUBIC  TEN  THOUSANDS  DIGIT  SECOND  TRANSPONDER  (integer) 

91.  CUBIC  AUTO  10000  DIGIT  CHANGE  D I SABLED ( 0 ) / ENABLED ( 1 )  FLAG 

92.  MARK  TYPE  NONE(O) ,  GENERAL ( 1 ) ,  LIGHT  HOUSE(2),  GREEN (3) ,  RED (4)  FLAG 

93.  BUFFER  OVERRUN  N0(0)/YES(1)  FLAG 

94.  SCREEN  DISPLAY  CROCS  SECTION( 1 ) /PLAN  VIEW(2) /BOTH(3)  FLAG 
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"SITE. CROS" 

8  BYTES  OF  FLAGS  FOR  PRINT  CROSS  SECTION,  DISPLAY  QUANTITIES  DISPLAY  CROSS 
SECTION,  PLOT  CROSS  SECTION,  PRINT  QUANTITIES,  PLOT  QUANTITIES,  ALIGN 
FAPER ,  PLOTTER  TYPE  (IN  FORM  8AI)  FOLLOWED  BY  CARRIAGE  RETURN 

21  BYTES  OF  PEN  CARRIAGE  NUMBERS  FOR  TEMPLATE,  ALLOWED  SIDE  SLOPE,  CENTER 
LINE,  SURFACE,  LETTERING,  PREDREDGE  DEPTHS,  POSTDREDGE  DEPTHS  (713) 
FOLLOWED  BY  CARRIAGE  RETURN 

18  BYTES  OF  LINE  TYPE  NUMBERS  FOR  TEMPLATE,  ALLOWED  SIDE  SLOPE,  CENTER  LINE, 
SURFACE,  PREDREDGE  DEPTHS,  POSTDREDGE  DEPTHS  (613)  FOLLOWED  BY  CARRIAGE 
RETURN 

48  BYTES  OF  DASH  LENGTH  PERCENTAGES  FOR  TEMPLATE,  ALLOWEI  SIDE  SLOPE,  CENTER 
LINE,  SURFACE,  PREDREDGE  DEPTHS,  POSTDREDGE  DEPTHS  (6F8.2)  FOLLOWED  BY 
CARRIAGE  RETURN 

40  BYTES  OF  LETTER  HEIGHT,  SCALE  X,  SCALE  Y,  PAPER  SIZE  X,  PAPER  SIZE  Y 
(5F8.2)  FOLLOWED  BY  CARRIAGE  RETURN 


ASCII  Data  File  Format 


LINE  BLOCK 

GROUPS  OF  LINE  BLOCKS 
THEN  EOF 

4  BYTES  OF  FILE  NAME  LENGTH  (in  characters)  FOLLOWED  EY  CARRIAGE  RETURN 
FILE  NAME  OF  DATA  FILE  (no.  of  characters  in  first  record  long) 

FOLLOWED  BY  CARRIAGE  RETURN 

23  BYTES  OF  DATE/TIME( in  form  _12-31-1988 _ 13:09:14.6)  THEN  CARRIAGE  RETURN 

14  BYTES  OF  LINE  LENGTH  (F14.2)  THEN  CARRIAGE  RETURN 

38  BYTES  OF  DIRECTION/CORRECTION  FLAGS (_DIRECTION_FLAG _ 0 _ CORRECTION_FLAG _ 1) 

THEN  CARRIAGE  RETURN 

1  BYTE  OF  DELIMETER  (ANY  CHARACTER  EXCEPT  R  OR  D)  THEN  CARP.  I  AGE  RETURN 

POSITION  ENTRY 

10  BYTE  POSITION  INDEX  (IN  FORM  _RANGE _ 11)  THEN  CARRIAGE  RETURN 

58  BYTE  TIME (seconds) ,  Easting,  Northing,  Distance  along  line .Distance 
off  line (F10 . 2 ,  4F12.2)  THEN  CARRIAGE  RETURN 

DEPTH  ENTRY 

10  BYTE  DEPTH  INDEX  (IN  FORM  _DEPTH _ 46)  THEN  CARRIAGE  RETURN 

22  BYTE  TIME (seconds) ,Depth(F10.2,  F12.2)  THEN  CARRIAGE  RETURN 

NOTE:  THE  DIRECTION  FLAG  IS  0  FOR  A  LINE  DEFINED  FROM  THE  LEFT  SIDE  OF  CHANNEL 
(1  FOR  RIGHT).  THE  CORRECT  FLAG  IS  0  FOR  LINE  RUN  (i.e.  DATA  COLLECTED)  FROM 
LEFT  TO  RIGHT  SIDE  OF  CHANNEL  (1  FOR  RIGHT  TO  LEFT) 

NOTE:  FILE  NAMES  SHOULD  BE  IN  FORM  ARLINGTON . 000 1 ,  ARLINGTON. 0002 ,  ETC.  WHERE 
THE  BASE  PART  IS  THE  SITE  NAME  (ARLINGTON)  AND  THE  EXTENSION  (.0001)  13  THE 
LINE  NUMBER  DEFINED  IN  THE  LINE  FILE. 


ASCII  Equipment  Description  File  Format 


"SITE. EQUI" 

6  BYTES  OF  RANGE  DEVICE  NUMBER  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
6  BYTES  OF  DEPTH  DEVICE  NUMBER  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
11  BYTES  0^  BOAT  ANTENNA  HEIGHT  (FI  1.2)  FOLLOWED  BY  CARRIAGE  RETURN 
6  BYTES  OF  NUMBER  OF  TRANSPONDER  LOCATIONS  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
BLOCKS  OF  TRANSPONDER  TRIORDINATES  (NUMBER  OF  BLOCKS  GIVEN  ABOVE) 

TRANSPONDER  TRIORDINATE  BLOCK 

11  BYTES  OF  TRANSPONDER  HEIGHT  (FI  1.2)  FOLLOWED  aY  CARRIAGE  RETURN 
11  BYTES  OF  TRANSPONDER  EASTING  (FI  1.2)  FOLLOWED  BY  CARRIAGE  RETURN 
11  BYTES  OF  TRANSPONDER  NORTHING  (FI  1.2)  FOLLOWED  BY  CARRIAGE  RETURN 


ASCII  Features  Index  File  Format 


"FEATURES" 

FILE  NAMES  OF  UP  TO  40  CHARACTERS  (A40)  FOLLOWED  BY  CARRIAGE  RETURN 
EOF 


ASCII  Feature  Data  File  Format 

"SITE. FEAT" 

BLOCKS  OF  FEATURE  ENTRIES  UNTIL  END  OF  FILE 

FEATURE  ENTRY  BLOCK 

12  BYTES  OF  PEN  CARRIAGE  SLOT,  LINE  TYPE,  DASHLENGTH  PERCENT  (IN  FORM  213, 
F6.2)  FOLLOWED  BY  CARRIAGE  RETURN 
BLOCKS  OF  FEATURE  COORDINATES  UNTIL  TERMINATOR 

30  BYTE  TERMINATOR  (EITHER  -998.,  -998.  OR  -999.,  -999.  IN  2F15.2)  THEN 
CARRIAGE  RETURN 

FEATURE  COORDINATES 

30  BYTE  EASTING,  NORTHING  (IN  2F15.2)  FOLLOWED  BY  CARRIAGE  RETURN 
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ASCII  Label  Data  File  Format 


"SITE. LABE" 

BLOCKS  OF  LABEL  INFORMATION 
EOF 


LABEL  BLOCK 

3  BYTES  OF  PEN  CARRIAGE  NUMBER  (13)  FOLLOWED  BY  CARRIAGE  RETURN 
6  BYTES  OF  LABEL  LENGTH  IN  CHARACTERS  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
LABEL  OF  UP  TO  120  CHARACTERS  (120A1)  FOLLOWED  BY  CARRIAGE  RETURN 
30  BYTES  Of  EASTING,  NORTHING  OF  LABEL  START  (2F15.2)  FOLLOWED  BY  CARRIAGE 
RETURN 

30  BYTES  OF  EASTING,  NORTHING  OF  LABEL  END  (2F15.2)  FOLLOWED  BY  CARRIAGE 
RETURN 
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ASCII  Label  Index  File  Format 


"LABELS" 

FILE  NAMES  OF  UP  TO  40  CHARACTERS  (A40)  FOLLOWED  BY  CARRIAGE  RETURN 
EOF 
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ASCII  Letters  Index  File  Format 


"LETTERS" 

FILE  NAMES  OF  UP  TO  40  CHARACTERS  (A40)  FOLLOWED  BY  CARRIAGE  RETURN 
EOF 
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ASCII  Letter  Data  File  Format 

"SITE. LETT" 

BLOCKS  OF  LINE  OR  TEXT  ENTRIES  UNTIL  END  OF  FILE 

LINE  ENTRY  BLOCK 

12  BYTES  OF  BLOCK  ROTATION  ANGLE  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  BLOCK  X  POSITION  FOLLOWED  BY  CARRIAGE  RETURN 

12  BYTES  OF  BLOCK  Y  POSITION  FOLLOWED  BY  CARRIAGE  RETURN 

6  BYTES  OF  PEN  CARRIAGE  SLOT  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  0.0  (LINE  FLAG)  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  LINE  START  X  FOLLOWED  BY  CARRIAGE  RETURN 

12  BYTES  OF  LINE  START  Y  FOLLOWED  BY  CARRIAGE  RETURN 

12  BYTES  OF  LINE  FINISH  X  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  LINE  FINISH  Y  FOLLOWED  BY  CARRIAGE  RETURN 

TEXT  ENTRY  BLOCK 

12  BYTES  OF  BLOCK  ROTATION  ANGLE  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  BLOCK  X  POSITION  FOLLOWED  BY  CARRIAGE  RETURN 

12  BYTES  OF  BLOCK  Y  POSITION  FOLLOWED  BY  CARRIAGE  RETURN 

6  BYTES  OF  PEN  CARRIAGE  SLOT  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  LETTER  HEIGHT  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  LETTER  ROTATION  ANGLE  FOLLOWED  BY  CARRIAGE  RETURN 
12  BYTES  OF  LETTER  START  X  FOLLOWED  BY  CARRIAGE  RETURN 

12  BYTES  OF  LETTER  START  Y  FOLLOWED  BY  CARRIAGE  RETURN 

256  BYTES  OF  TEXT 
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ASCII  Line  File  Format 


6  BYTES  OF  NUMBER  OF  FIVE-LINE-IDENTIFICAi ION-BLOCKS  (16)  FOLLOWED  BY  CARRIAGE 
RETURN 

BLOCKS  OF  5  FORTY  CHARACTER  LINES  OF  DESCRIPTION  (NO.  OF  BLOCKS  IN  RECORD  1), 
EACH  LINE  FOLLOWED  BY  CARRIAGE  RETURN 

6  BYTES  OF  NUMBER  OF  CHANNEL  COORDINATE  INDICES  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
BLOCKS  OF  CHANNEL  COORDINATES  (SEE  FORMAT  BELOW, 

6  BYTES  OF  NUMBER  OF  SECTION  LINES  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
BLOCKS  OF  SECTION  LINES  (SEE  FORMAT  BELOW) 


56  CHARACTERS 
NORTHING 
56  CHARACTERS 
NORTHING 
47  CHARACTERS 
(IN  FORM 


CHANNEL  COORDINATE  BLOCK 

OF  CHANNEL  LEFT  EASTING,  CH  LEFT  NORTHING,  CH  RT  EASTING,  CH  RT 
(IN  FORM  4E14.7)  FOLLOWED  BY  CARRIAGE  RETURN 

OF  BASELINE  EASTING,  B.L.  NORTHING,  CEN  JR  LINE  EASTING,  C.L. 
(IN  FORM  4E14.7)  FOLLOWED  BY  CARRIAGE  RETURN 

CF  LEFT  RISE,  LEFT  RUN,  PROJECT  DEPTH,  OVERDEPTH, RT  RISE.RT  RUN 
217,  2F13.6,  217)  FOLLOWED  BY  CARRIAGE  RETURN 


23  CHARACTERS 
17, Al) 

56  CHARACTERS 
EASTING, 


SECTION  LINE  BLOCK 

OF  STATION  NUMBER,  SECTION  INDEX , CHANNEL  SIDE  (IN  FORM  E14.7, 

OF  SECTION  LINE  START  EASTING,  S.L.  START  NORTHING,  S.L.  FINISH 
S.L.  FINISH  NORTHING  (IN  FORM  4E14.7) 


NOTE:  SECTION  INDEX  IS  THE  CHANNEL  SECTION  THAT  THE  SECTION  LINZ  FALLS  IN  AS 
DEFINED  BY  THE  CHANNEL  COORDINATE  BLOCK  INDEX  FOR  THE  CHANNEL  BREAK  IMMEDI¬ 
ATELY  PRECEDING  THE  SECTION  LINE.  THE  CHANNEL  SIDE  ENTRY  IS  L  FOR  SECTION 
LINE  BEGINNING  ON  THE  LEFT  SIDE  OF  THE  CHANNEL  (R  FOR  RIGHT  SIDE). 
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ASCII  Marks  Description  File  Format 


"SITE. MARK" 

5  BYTES  OF  NUMBER  OF  MARKS  IN  FILE  (15)  FOLLOWED  BY  A  CARRIAGE  RETURN 
BLOCKS  OF  M^RKS  DESCRIPTION  (NUMBER  OF  BLOCKS  GIVEN  ABOVE) 

MARK  BLOCK 

3  BYTES  OF  PEN  CARRIAGE  SLOT  (13)  FOLLOWED  BY  CARRIAGE  RETURN 
3  BYTES  OF  SPECIAL  SYMBOL  NUMBER  (13)  FOLLOWED  BY  CARRIAGE  RETURN 
13  BYTES  OF  MARK  EASTING  ^F13.1)  FOLLOWED  BY  CARRIAGE  RETURN 
13  BYTES  OF  MARK  NORTHING  (F13.1)  FOLLOWED  BY  CARRIAGE  RETURN 
40  BYTES  (OR  LESS)  OF  MARK  LABEL  (40A1)  FOLLOWED  BY  CARRIAGE  RETURN 


D 1  4 


Binary  Data  File  Format 


TIDE 

"SITE . D001 " 

12  BYTES  OF  DATE  (GRID  FORMAT) 

4  BYTES  OF  DATA  IDENTIFIER (250)  AND  RELATIVE  TIME 
4  BYTES  OF  TIDE  VALUE  IN  FLOATING  POINT 

MARK 

"SITE. MOOT’ 

12  BYTES  OF  DATE  (GRID  FORMAT) 

4  BYTES  OF  DATA  IDENTIFIER(251 )  AND  RELATIVE  TIME 
4  BYTES  OF  EASTING  IN  FLOATING  POINT 
4  BYTES  OF  NORTHING  IN  FLOATING  POINT 
4  BYTES  OF  DEPTH  IN  FLOATING  POINT 

POSITION  &  DEPTH  DATA 
"SITE. 0001" 

12  BYTES  OF  DATE  (GRID  FORMAT) 

POSITION  ENTRY 

4  BYTES  OF  DATA  IDENTIFIER( 10)  AND  RELATIVE  TIME 
4  BYTES  OF  EASTING  IN  FLOATING  POINT 
4  BYTES  OF  NORTHING  IN  FLOATING  POINT 
4  BYTES  OF  DISTANCE  ALONG  LINE  IN  FLOATING  POINT 
4  BYTES  OF  DISTANCE  OFFLINE  IN  FLOATING  POINT 

DEPTH  ENTRY 

4  BYTES  OF  DATA  IDENTIFIER^)  AND  RELATIVE  TIME 
4  BYTES  OF  DEPTH  IN  FLOATING  POINT 


NOTE:  SITE  is  the  site  identifier  name;  the  number 
001  is  the  number  of  the  particular  tide 
entry,  Mark  entry,  or  Data  file  and  ranges  to 
999  or  9999. 

NOTE:  Data  Identifier  is  a  2  byte  integer;  Relative 
time  is  a  2  byte  integer  representing  number 
of  tenths  of  second  since  the  time  in  the 
date  record  at  the  beginning  of  file. 
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Auxiliary  Run-Time  Common  Block  of  Memory  Layout  (BUFF2) 


EACH  INDEX  VALUE  CORRESPONDS  TO  4  BYTES 

1-50  SITE  TEXT  CHARACTER  INFORMATION  (5  FORTY  CHARACTER  LINES) 

51-75  NOT  USED 

76-200  CHANNEL  INDEX  NUMBER  OF  LINE  (500) 

201-250  HEIGHTS  OF  TRANSPONDERS  FLOATING  POINT  (5G) 

251-300  NORTHINGS  OF  TRANSPONDERS  FLOATING  POINT  (50) 

301-350  EASTINGS  OF  TRANSPONDERS  FLOATING  POINT  (50) 

351-400  PROJECT  DEPTHS  OF  CHANNEL  INDICES  FLOATING  POINT  (50) 

401-450  BASELINE  EASTINGS  OF  CHANNEL  INDICES  FLOATING  POINT  (50) 

451-500  BASELINE  NORTHINGS  OF  CHANNEL  INDICES  FLOATING  POINT  (50) 
501-550  CENTER  LINE  EASTING  OF  CHANNEL  INDEX  FLOATING  POINT  (50) 

551-600  CENTER  LINE  NORTHING  OF  CHANNEL  INDEX  FLOATING  POINT  (50) 
601-650  CHANNEL  TOE  LEFT  EASTING  OF  CHANNEL  INDEX  FLOATING  POINT  (50) 
651-700  CHANNEL  TOE  LEFT  NORTHING  OF  CHANNEL  INDEX  FLOATING  POINT  (50) 
701-750  CHANNEL  TOE  RIGHT  EASTING  OF  CHANNEL  INDEX  FLOATING  POINT  (50) 
751-800  CHANNEL  TOE  RIGHT  NORTHING  OF  CHANNEL  INDEX  FLOATING  POINT  (50) 
801-850  OVERDEPTH  OF  CHANNEL  INDEX  FLOATING  POINT  (50) 

851-875  RISE  OF  LEFT  SIDE  OF  CHANNEL  (50) 

876-900  RUN  OF  LEFT  SIDE  OF  CHANNEL  (50) 

901  NOT  USED 

902  NUMBER  OF  CHANNEL  INDICES  (INTEGER) 

903  NUMBER  OF  SECTION  LINES  (INTEGER) 

904  1' UMBER  OF  TRANSPONDER  TRIORDINATES  (INTEGER) 

905  HEIGHT  OF  BOAT  ANTENNA 
906-909  SITE  NAME 

910  NUMBER  OF  CHARACTERS  IN  SITE  NAME 
911-999  NOT  USED 

1001-1500  STATION  _jER  FLOATING  POINT  (500) 

1501-2000  SECTION  LINE  START  EASTING  (500) 

2001-2500  SECTION  LINE  START  NORTHING  (500) 

2501-3000  SECTION  LINE  FINISH  EASTING  (500) 

3001-3500  SECTION  LINE  FINISH  NORTHING  (500) 

3501  CENTER-LINE  PLOT/CHANNEL  LINE  PLOT  PEN  NUMBERS 

3502  BASELINE  PLOT/DEPTH  PLOT  PEN  NUMBERS 

3503  LEGEND  PLOT/SECTION  LINE  PLOT  PEN  NUMBERS 

3504  ARROW  PLOT/TRANSPONDERS  PLOT  PEN  NUMBERS 

3505  CENTER-LINE  PLOT/CHANNEL  LINE  PLOT  LINE  TYPES 

3506  BASELINE  PLOT/SECTION  LINE  PLOT  LINE  TYPES 

3507  CENTER-LINE  DASH  WIDTH  PERCENTAGE 

3508  CHANNEL  LINES  DASH  WIDTH  PERCENTAGE 

3509  BASELINE  DASH  WIDTH  PERCENTAGE 

3510  SECTION  LINE  DASH  WIDTH  PERCENTAGE 

3511  DEPTH  LETTER  HEIGHT  PLOT 

3512  SECTION  LINE  LETTER  HEIGHT  PLOT 

3513  ARROW  I "NGTH  PLOT 

3514  ARROW  X-POSITION  PLOT 

3515  LEGEND  HEADER  LETTER  HEIGHT 

3516  LEGEND  ENTRY  LETTER  HEIGHT 

3517  PEN  FOR  GRID  MARKS  /  NUMBER  OF  CHAR -CTERS  IN  LEGEND  TITLE 

3518  LETTER  HEIGHT  OF  GRID  MARKS 


3519  LEGEND  CORNER  /  HARDWARE  ROTATION  ANGLE 

3520  X-POSITION  OF  LEGEND  REFERENCE 

3521  Y-POSITION  OF  LEGEND  REFERENCE 

3522  TRANSPONDER  SYMBOL  /  ALIGN  PAPER  FLAG 

3523  PLOT  LOWER  LEFT  EASTING 

3524  PLOT  LOWER  LEFT  NORTHING 

3525  SOFTWARE  ROTATION  POINT  EASTING 

3526  SOFTWARE  ROTATION  POINT  NORTHING 

3527  SOFTWARE  ROTATION  ANGLE 

3528  SCALE  OF  PLOT 

3529  SOFTWARE  ROTATION  POINT  X-VALUE 

3530  SOFTWARE  ROTATION  POINT  Y-VALUE 

3531  GRID  MARK  SPACING 

3532-3541  LEGEND  TITLE  (UP  TO  40  CHARACTERS) 

3542  Y-POSITION  OF  ARROW 

3543  HEIGHT  OF  TRANSPONDER  SYMBOL 
3544-3549  NOT  USED 

3551-3675  CHANNEL  SIDE  FLAG  (500) 
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ASCII  Site  File  Format 


"SITE. SITE" 

6  BYTES  OF  NUMBER  OF  FIVE-LINE-IDENTIFICATION-BLOCKS  (16)  FOLLOWED  BY  CARRIAGE 
RETURN 

BLOCKS  OF  S  FORTY  CHARACTER  LINES  OF  DESCRIPTION  (NO.  OF  BLOCKS  IN  RECORD  1). 

EACH  LINE  FOLLOWED  BY  CARRIAGE  RETURN 
6  BYTES  OF  NUMBER  OF  CHANNEL  COORDINATE  INDICES  (16)  FOLLOWED  BY  CARRIAGE 
RETURN 

BLOCKS  OF  CHANNEL  COORDINATES  (SEE  FORMAT  BELOW) 

6  BYTES  OF  NUMBER  OF  SECTION  LINE  GENERATION  PARAMETER  GROUPS  TO  FOLLOW  THEN 
CARRIAGE  RETURN 

BLOCKS  OF  SECTION  LINE  PARAMETER  GROUPS  (SEE  FORMAT  BELOW) 

CHANNEL  COORDINATE  BLOCK 

56  CHARACTERS  OF  CHANNEL  LEFT  EASTING,  CH  1.EFT  NORTHING,  CH  RT  EASTING,  CH  RT 
NORTHING  t,IN  FORM  4E14.7)  FOLLOWED  BY  CARRIAGE  RETURN 
56  CHARACTERS  OF  BASELINE  EASTING,  B.L.  N  ..THING,  CENTER-LINE  EASTING,  C.L. 

NORTHING  (IN  FORM  4E14.7)  FOLLOWED  BY  CARRIAGE  RETURN 
47  CHARACTERS  OF  LEFT  RISE,  LEFT  RUN,  PROJECT  DEPTH,  OVERDEPTH, RT  RISE ,RT  RUN 
(IN  FORM  217,  2F13.6,  217)  FOLLOWED  BY  CARRIAGE  RETURN 

SECTION  LINE  PARAMETER  GROUPS 


RECTANGULAR  METHOD 

6  BYTES  OF  GROUP  TYPE  IDENTIFIER  (  1)  FOLLOWED  BY  CARRIAGE  RETURN 

56  CHARACTERS  OF  STATION  NUMBER,  STATION  INCREMENT,  EASTING  START,  NORTHING 
START  (IN  FORM  4E14.7)  FOLLOWED  BY  CARRIAGE  RETURN 
54  CHARACTERS  OF  EASTING  FINISH,  NORTHING  FINISH,  OFFSET,  NUMBER  OF  LINES, 
SECTION  INDEX  (IN  FORM  3E14.7,  216)  FOLLOWED  BY  CARRIAGE  RETURN 

NONRECTANGULAR  METHOD 

6  RYTES  OF  GROUI  TYPE  IDENTIFIER  (  2)  FOLLOWED  BY  CARRIAGE  RETURN 

56  CHARACTERS  OF  STATION  NUMBER,  STATION  INCREMENT,  EASTING  START,  NORTHING 
START  (IN  FORM  4E14.7)  FOLLOWED  BY  CARRIAGE  RETURN 
54  CHARACTERS  OF  EASTING  FINISH,  NORTHING  FINISH,  OFFSET,  NUMBER  OF  LINES, 
SECTION  INDEX  (IN  FORM  3E14.7,  216)  FOLLOWED  BY  CARRIAGE  RETT  DIN 
56  CHARACTERS  OF  REFERENCE  START  EASTING,  R.S.  NORTHING,  REFERENCE  FINISH 
EASTING,  R.F.  NORTHING  (IN  FORM  4E14.7)  FOLLOWED  BY  CARRIAGE  RETURN 

CHANNEL  BASED  METHOD 

6  BYTES  OF  GROUP  TYPE  IDENTIFIER  ( _ 3)  FOLLOWED  BY  CARRIAGE  RETURN 

56  CHARACTERS  OF  STATION  NUMBER,  STATION  INCREMENT,  EXTENSION  LEFT,  EXTENSION 
RIGHT  (IN  FORM  4EI4.7)  FOLLOWED  BY  CARRIAGE  RETURN 
26  CHARACTERS  OF  SECTION  INDEX,  OFFSET,  NUMBER  OF  LINES  (IN  FORM  16,  E14.7, 
16)  FOLLOWED  BY  CARRIAGE  RETURN 
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ASCII  Screen  Image  Index  File  Format 


"SCREEN_IMAGES" 

BLuuKS  OF  SCREEN  DESCRIPTukS 
EOF 


IMAGE  DESCRIPTOR  BLOCK 

FILE  NAME  AS  A  CHARACTER  STRING  (up  to  71  characters)  FOLLOWED  BY  CARRIAGE 
RETURN 

6  BYTES  OF  WIDTH  OF  IMAGE  IN  PIXELS  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
6  BYTES  OF  HEIGHT  OF  IMAGE  IN  PIXELS  (16)  FOLLOWED  BY  CARRIAGE  RETURN 
6  BYTES  OF  CARRIAGE  SLOT  FOR  PEN  (16)  FOLLOWED  BY  CARRIAGE  RETURN 

13  BYTES  OF  SCALE  IN  FREE  FIELD  (F13.0)  FOLLOWED  BY  CARRIAGE  RETURN 

13  BYTES  OF  X-ORIGIN  IN  FREE  FIELD  (F13.0)  FOLLOWED  BY  CARRIAGE  RETURN 

13  BYTES  OF  Y-ORIGIN  IN  FREE  FIELD  (F13.0)  FOLLOWED  BY  CARRIAGE  RETURN 

13  BYTES  OF  SOFTWARE  ROTATION  ANGLE  IN  FREE  FIELD  (FI 3.0)  FOLLOWED  BY  CARRIAGE 
RETURN 
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ASCII  Plan  View  Description  File  Format 


"SITE. PLAN" 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  CENTER  LINE  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  CHANNEL  LINES  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  BASELINE  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  DEPTHS  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  LEGEND  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  SECTION  LINES  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  GRID  MARKS  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  ARROW  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  TRANSPONDERS  (12)  FOLLOWED  BY  CARRIAGE 
RETURN 

OPTIONAL  BLOCKS  OF  LINE  INFORMATION  (SEE  FORMAT  BELOW)  CL,  CH ,  BL,  SL 
OPTIONAL  BLOCKS  G 7  LETTER  HEIGHT  INFORMATION  ^EE  FORMAT  BELOW)  DEPih ,  Gimu, 

SL 

OPTIONAL  ARROW  BLOCK  INFORMATION  (SEE  FORMAT  BELOW) 

OPTIONAL  LEGEND  BLOCK  INFORMATION  (SEE  FORMAT  BELOW) 

OPTIONAL  TRANSPONDER  BLOCK  INFORMATION  (SEE  FORMAT  BELOW) 

14  BYTES  OF  PLOT  SCALE  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

14  BYTES  OF  GRID  MARK  SEPARATION  DISTANCE  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
4  BYTES  OF  HARDWARE  ROTATE  ANGLE  (0,  90,  OR  -1  IN  14  FORMAT)  FOLLOWED  BY 
CARRIAGE  RETURN 

EITHER  HARDWARE  ROTATE  BLOCK  (IF  0  OR  90)  OR  SOFTWARE  ROTATE  BLOCK  (IF  -1) 
FOLLOWED  BY  CARRIAGE  RETURN 

1  BYTE  OF  ALIGN  PAPER  FLAG  (Al)  FOLLOWED  BY  CARRIAGE  RFTIT?W 

4  BYTES  OF  PEN  CARRIAGE  SLOT  FOR  CONTOUR  (14)  FOLLOWED  BY  CARRIAGE  RETURN 
OPTIONAL  CONTOUR  BLOCK  INFORMATION  (SEE  FORMAT  BELOW) 

LINE  BLOCK 

2  BYTES  OF  DASH  TYPE  (12)  FOLLOWED  BY  CARRIAGE  RETURN 

OPTIONAL  14  BYTES  OF  DASH  LENGTH  PERCENTAGES  (F14.2)  FOLLOWED  BY  CARRIAGE 
RETURN 

LETTER  HEIGHT  BLOCK 

14  BYTES  OF  LETTER  HEIGHT  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

ARROW  BLOCK 

14  BYTES  OF  ARROW  LENGTH  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  X  PAPER  POSITION  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

14  BYTES  OF  Y  PAPER  POSITION  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

LEGEND  BLOCK 

14  BYTES  OF  LETTER  HEIGHT  FOR  LEGEND  HEADER  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

14  BYTES  OF  LETTER  HEIGHT  FOR  LEGEND  ENTRIES  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
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2  BYTES  OF  NUMbER  OF  LEGEND  HEADER  CHARACTERS  (12)  FOLLOWED  BY  CARRIAGE  RETURN 
LEGEND  HEADER  (NUMBER  OF  BYTES  IK  ABOVE  RECORD  LONG)  FOLLOWED  BY  CARRIAGE 
RETURN 

2  BYTES  OF  REFERENCE  CORNER  FOR  LEGEND  (A2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  LEGEND  REFERENCE  X  POSITION  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  LEGEND  REFERENCE  Y  POSITION  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

TRANSPONDER  BLOCK 

14  BYTES  OF  LETTER  HEIGHT  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
2  BYTES  OF  SYMBOL  NUMBER  (12)  FOLLOWED  BY  CARRIAGE  RETURN 

HARDWARE  ROTATE  BLOCK 

14  BYTES  OF  LOWER  LEFT  EASTING  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
OPTIONAL  14  BYTES  OF  LOWER  LEFT  NORTHING  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

SOFTWARE  ROTATE  BLOCK 

14  BYTES  OF  ROTATION  ANGLE  (FI 4. 2)  FOLLOWED  BY  CARRIAGE  RETURN 
It-  BYTES  OF  ROTATION  POINT  EASTING  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  ROTATION  POINT  NORTHING  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  ROTATION  POINT  X-POSITION  (T14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  ROTATION  POINT  Y-POSITION  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 

CONTOUR  BLOCK 

14  BYTES  OF  SHALLOWEST  DEPTH  TO  CONTOUR  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  DEEPEST  DEPTH  TO  CONTOUR  (F14.2)  FOLLOWED  BY  CARRIAGE  RETURN 
14  BYTES  OF  LETTER  HEIGHT  FOR  CONTOUR  LABEL  (FI 4. 2)  FOLLOWED  BY  CAKKiAGE 
RETURN 

2  BYTES  OF  NUMBER  OF  CONTOUR  LEVELS  (12)  FOLLOWED  BY  CARRIAGE  RETURN 
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Allowed  sideslope  -  area  below  channel  template  sides  which  is  not  required  to 
be  dredged 

Analog  style  -  continuous  reading,  infinite  resolution  type  device 
Channel  template  -  cross  section  view  of  desired  channel 

Communication  links  (radio  links)  -  radio  transmission  paths  and  equipment  for 
sending  data  from  boat  to  shore  or  vice  versa 

Concurrent  tasks  -  programs  which  interleave  in  time  to  give  the  appearance  of 
simultaneous  operation 

Cross-section  line  -  line  used  to  indicate  desired  boat  survey  path  across  a 
channel 

Data  loggers  -  storage  devices  which  record  gathered  data 

Depth  chart  -  a  graph  of  depth  versus  paper  motion  (i.e.  time)  produced  by 
some  depth  sounder  systems;  it  will  not  be  linear  with  respect  to  position 
unless  boat  speed  is  constant  along  the  desired  line 

Depth  sounder  -  electronic  depth  determining  instrument 

Disk  drive  -  rotating  magnetic  media  storage  device 

Electronic  positioning  -  gathering  of  position  data  using  electronic  equipment 

Electronic  surveying  tools  (equipment)  -  electronic  equipment  used  to  automate 
gathering  of  survey  data 

Firmware  -  program  stored  in  read-only  memory 

Form  -  a  dialog  box  on  the  computer  screen  used  for  user-friendly  data  entry 

FORTRAN  ("FORMULA  TRANSLATION")  -  a  programming  language  designed  for 
scientists  and  engineers  used  extensively  by  the  Corps  of  Engineers 

Global  satellite  positioning  -  positioning  method  based  on  three  or  four 
distances . 

Hydrographic  surveys  -  surveys  conducted  on  water  to  gather  data  such  as  depth 
versus  position 

Joystick  -  device  which  changes  mechanical  motion  to  electronic  energy  change 

Menu  -  a  list  of  choices  used  for  user-friendly  selection  of  an  option 

Modem  ("modulator  demodulator")  -  device  which  allows  digital  data  to  be 
transmitted  via  telephone  or  radio  links 

On-line  -  during  the  data  collection  period 

Overdepth  -  area  below  channel  template  bottom  which  is  not  required  to  be 
dredged 

Piecewise  linear  interpolation  -  method  of  determining  position  at  a  given 
depth's  sample  time  based  on  the  relative  time  from  the  depth  sampling  to  the 
positions  taken  immediately  before  and  after  the  depth 

Pilot  guidance  -  a  left/right  gage  indicating  direction  to  steer  the  boat  to 
follow  a  predetermined  line 

Prioritized  multitasking  -  a  system  by  which  the  program  assigned  the  lowest 
"priority"  number  that  is  able  to  run  is  selected  by  the  operating  system  to 
run 
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Prism  -  a  circular  glass  target  that  reflects  light  back  toward  its  source 

Profile  line  -  line  used  to  indicate  desired  boat  survey  path  along  a  channel 

Quiz  character  -  a  method  of  triggering  a  device  to  take  a  sample  and  transmit 
it  to  the  computer 

Range-azimuth  -  positioning  method  based  on  a  distance  and  one  or  more  angles 
Range-range  -  positioning  method  based  on  two  distances 

Removable  cartridge  bubble  drive  -  a  storage  device  using  plug-in  cassettes 
which  contain  magnetic  bubble  memory  modules 

Section  line  -  line  used  to  indicate  desired  boat  survey  path 

Servo-drive  -  system  where  a  motor  turns  proportionally  to  the  motion  of  a 
joystick 

Software  package  -  a  program  or  group  of  programs  designed  to  perform  a 
particular  function 

Space  diversity  -  using  two  transponders  at  a  position  to  reduce  position 
errors  due  to  reflected  rather  than  direct  path  radio  signals 

Spawn  -  load  a  program  from  disk  and  start  it  running  at  a  particular  priority 

Tablet  digitizer  -  a  device  for  converting  a  map  via  manual  motion  of  a 
magnetic  coil  along  the  map  to  computer  data 

Tasks  -  programs  which  interact  with  other  programs 

Theodolite  -  surveying  instrument  used  to  determine  angles  and  distances 
Tide  gages  -  instruments  which  measure  relative  water  level 
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